TQ-20

Description Wiki or Documentation Link Only

Text Quality

Default severity: high
ProcessMetrics

What it detects

Description is essentially a wiki/Confluence/documentation URL with no local requirement essence (~5.6% antipattern).

Detection formula

IF description is URL-only or wiki host with <50 chars of local text THEN FLAG

Examples in practice

  • Description is only https://confluence.example.com/display/PROJ/Spec

Suggested response

Paste the requirement into the ticket; keep the wiki link as supplementary reference only.

Coaching playbook

Symptom

Description is essentially a wiki/Confluence/documentation URL with no local requirement essence (~5.6% antipattern).

Why it matters

When "Description Wiki or Documentation Link Only" keeps appearing, the team is signalling a repeatable process gap. Left unexamined, the pattern hides where work really stalls and makes improvement metrics harder to trust.

What you can achieve

Paste the requirement into the ticket; keep the wiki link as supplementary reference only.

Facilitation questions

  • What system change would stop "Description Wiki or Documentation Link Only" from firing again?
  • What do the cited issues have in common — same root cause or same workaround?
  • Who owns the two-week experiment and how will we verify on the next import?

Run this rule against your own tracker data with Flow Analyzer.

Product tourSign in
TQ-20: Description Wiki or Documentation Link Only — FlowAnalyzer