Knowledge lifecycle governance
Most knowledge bases rot through calendar review nobody completes, not through
neglect. An article gets a yearly "review due" date, the reminder fires, someone
clicks through unchanged, and the system records it as current. Meanwhile the
product changed six months ago and the article customers actually read — because
search surfaces it — is wrong.
The prize is not a tidy review log. It is articles that stay correct under the
load they carry, with a clear owner when they drift, and a deprecation path that
does not 404 customers mid-journey.
The failure modes
| Symptom |
Fault |
| Articles have no named owner |
Nobody is accountable when policy changes |
| Review is calendar-only |
High-traffic stale content waits for a date |
| "Reviewed" means opened, not verified |
False confidence; worse than no review |
| Orphan articles after reorg |
Owner left; content drifts with no alerts |
| Deprecated articles deleted or 404'd |
Broken links, search gaps, angry customers |
| Low-traffic articles reviewed first |
Effort spent where harm is lowest |
Assign ownership before cadence
Every published article needs one accountable owner — a role or team, not a
person's name alone. The owner is responsible for factual currency when the
underlying policy, product or process changes, not for prose polish.
| Owner type |
Owns |
| Product / policy team |
What is true — fees, eligibility, timelines |
| Support ops / KB lead |
Structure, findability, deprecation, metadata |
| Localisation lead |
Translation currency when source changes |
Orphan detection: articles whose owner role no longer exists, whose owner field is
blank, or whose owner has not logged in since the article was last materially edited.
Orphans are the highest-risk stale content — nobody receives the alert when the
topic changes.
Review triggered by usage and staleness, not calendar alone
Calendar review is a backstop, not the engine. Prioritise review when both are
true:
- Staleness signal —
updated_at older than the last known change on that
topic, or older than a topic-specific threshold (refund policy: 90 days; a
feature overview: tied to release cadence).
- Usage signal — views, search impressions, agent citations, AI grounding
frequency, or contact-after-view rate above baseline.
A stale article nobody reads is housekeeping. A stale article customers and agents
hit constantly is an incident waiting to happen — treat it like one.
Suggested priority tiers:
| Tier |
Trigger |
Action |
| P0 |
High usage + confirmed policy/product change |
Verify within days; unpublish if wrong |
| P1 |
High usage + stale by age or drift signal |
Full factual review |
| P2 |
Medium usage + stale |
Review on next sprint |
| P3 |
Low usage + stale |
Deprecate or merge candidate; do not spend a full review |
Low-traffic content does not need the same cadence as head articles. Equal
calendar review for every article is how teams burn out and miss the ones that
matter.
What "review" means
A review is not opening the page. It is:
- Verify every factual claim against current policy, product behaviour and links.
- Check findability — do titles and headings use the words customers search?
- Check duplication — does another article answer the same question differently?
- Record what changed —
updated_at must move only when content or metadata
materially changed, not when someone clicked approve.
If nothing changed, say so explicitly in the review log. That is valid — but
distinguish "verified unchanged" from "nobody looked."
Deprecation without 404ing customers
Never delete a published article customers may bookmark, that search indexes, or
that external sites link to. Deprecation is a controlled wind-down:
- Mark status — deprecated, superseded, or archived (use your platform's
equivalent; do not leave it looking live).
- Choose canonical successor — one article, not three overlapping replacements.
- Redirect or prominent banner — old URL resolves to the successor, or shows
"This article is outdated — see [link]" above the fold.
- Update internal references — macros, AI grounding lists, agent shortcuts,
onboarding docs. Deprecation that only changes the help centre leaves agents
citing the old page.
- Retain for audit — keep the old body accessible to staff even if hidden from
customers.
- Measure after 30–60 days — contact rate on the topic, search failures for old
terms, broken-link reports.
Hard deletion is only for drafts, duplicates never published, or content that was
factually harmful and has no legitimate reason to exist.
Governance rhythm
| Activity |
Cadence |
| Orphan scan |
Monthly |
| P0/P1 review queue |
Weekly |
| Owner accountability check |
Quarterly — can each owner name their top 5 articles? |
| Calendar backstop for long-tail |
Annual, P3 only |
| Post-incident KB check |
Within 48h of any policy or product change that affects customers |
Tie KB updates to change management, not documentation sprints. When policy
changes, the article owner is in the same Slack thread as the announcement — not
discovering it from a customer ticket three weeks later.
Traps
- Review completion rate as a KPI. Teams game it; wrong articles get marked
reviewed.
- Equal ownership of the whole KB. "Support owns the KB" means nobody owns
anything.
- Deprecating without checking AI and macro references. The article vanishes from
the help centre but still grounds answers.
- Assuming low views means safe to delete. Unused in conversation matching is not
the same as unused in reality — check views and agent citations first.
- Publishing a replacement before redirecting the old URL. You now have two
live answers and split traffic.
Present results to the user
- Orphan and unowned article list, with usage tier attached.
- Priority review queue — usage × staleness ranked, not alphabetical.
- Proposed ownership map — role per article or section, with gaps named.
- Review policy — tier definitions, triggers, and what "done" means.
- Deprecation candidates — with successor, redirect plan and reference check
list (macros, AI, internal wiki).
- Governance calendar — what runs weekly, monthly, quarterly; tied to change
management not documentation theatre.
1---2name: cx-knowledge-lifecycle3description: Use to assign ownership, set review cadence, and deprecate support content without breaking self-service or AI grounding. Trigger for "who owns this article", "our KB is out of date", orphan articles, annual review calendar nobody follows, deprecating help content, knowledge governance, or preventing stale articles from quietly harming customers.4---56# Knowledge lifecycle governance78Most knowledge bases rot through **calendar review nobody completes**, not through9neglect. An article gets a yearly "review due" date, the reminder fires, someone10clicks through unchanged, and the system records it as current. Meanwhile the11product changed six months ago and the article customers actually read — because12search surfaces it — is wrong.1314The prize is not a tidy review log. It is **articles that stay correct under the15load they carry**, with a clear owner when they drift, and a deprecation path that16does not 404 customers mid-journey.1718## The failure modes1920| Symptom | Fault |21| --- | --- |22| Articles have no named owner | Nobody is accountable when policy changes |23| Review is calendar-only | High-traffic stale content waits for a date |24| "Reviewed" means opened, not verified | False confidence; worse than no review |25| Orphan articles after reorg | Owner left; content drifts with no alerts |26| Deprecated articles deleted or 404'd | Broken links, search gaps, angry customers |27| Low-traffic articles reviewed first | Effort spent where harm is lowest |2829## Assign ownership before cadence3031Every published article needs **one accountable owner** — a role or team, not a32person's name alone. The owner is responsible for factual currency when the33underlying policy, product or process changes, not for prose polish.3435| Owner type | Owns |36| --- | --- |37| Product / policy team | What is true — fees, eligibility, timelines |38| Support ops / KB lead | Structure, findability, deprecation, metadata |39| Localisation lead | Translation currency when source changes |4041Orphan detection: articles whose owner role no longer exists, whose owner field is42blank, or whose owner has not logged in since the article was last materially edited.43**Orphans are the highest-risk stale content** — nobody receives the alert when the44topic changes.4546## Review triggered by usage and staleness, not calendar alone4748Calendar review is a backstop, not the engine. Prioritise review when **both** are49true:50511. **Staleness signal** — `updated_at` older than the last known change on that52 topic, or older than a topic-specific threshold (refund policy: 90 days; a53 feature overview: tied to release cadence).542. **Usage signal** — views, search impressions, agent citations, AI grounding55 frequency, or contact-after-view rate above baseline.5657A stale article nobody reads is housekeeping. **A stale article customers and agents58hit constantly is an incident waiting to happen** — treat it like one.5960Suggested priority tiers:6162| Tier | Trigger | Action |63| --- | --- | --- |64| P0 | High usage + confirmed policy/product change | Verify within days; unpublish if wrong |65| P1 | High usage + stale by age or drift signal | Full factual review |66| P2 | Medium usage + stale | Review on next sprint |67| P3 | Low usage + stale | Deprecate or merge candidate; do not spend a full review |6869Low-traffic content does not need the same cadence as head articles. **Equal70calendar review for every article is how teams burn out and miss the ones that71matter.**7273## What "review" means7475A review is not opening the page. It is:76771. **Verify every factual claim** against current policy, product behaviour and links.782. **Check findability** — do titles and headings use the words customers search?793. **Check duplication** — does another article answer the same question differently?804. **Record what changed** — `updated_at` must move only when content or metadata81 materially changed, not when someone clicked approve.8283If nothing changed, say so explicitly in the review log. That is valid — but84distinguish "verified unchanged" from "nobody looked."8586## Deprecation without 404ing customers8788Never delete a published article customers may bookmark, that search indexes, or89that external sites link to. Deprecation is a **controlled wind-down**:90911. **Mark status** — deprecated, superseded, or archived (use your platform's92 equivalent; do not leave it looking live).932. **Choose canonical successor** — one article, not three overlapping replacements.943. **Redirect or prominent banner** — old URL resolves to the successor, or shows95 "This article is outdated — see [link]" above the fold.964. **Update internal references** — macros, AI grounding lists, agent shortcuts,97 onboarding docs. Deprecation that only changes the help centre leaves agents98 citing the old page.995. **Retain for audit** — keep the old body accessible to staff even if hidden from100 customers.1016. **Measure after 30–60 days** — contact rate on the topic, search failures for old102 terms, broken-link reports.103104Hard deletion is only for drafts, duplicates never published, or content that was105factually harmful and has no legitimate reason to exist.106107## Governance rhythm108109| Activity | Cadence |110| --- | --- |111| Orphan scan | Monthly |112| P0/P1 review queue | Weekly |113| Owner accountability check | Quarterly — can each owner name their top 5 articles? |114| Calendar backstop for long-tail | Annual, P3 only |115| Post-incident KB check | Within 48h of any policy or product change that affects customers |116117Tie KB updates to **change management**, not documentation sprints. When policy118changes, the article owner is in the same Slack thread as the announcement — not119discovering it from a customer ticket three weeks later.120121## Traps122123- **Review completion rate as a KPI.** Teams game it; wrong articles get marked124 reviewed.125- **Equal ownership of the whole KB.** "Support owns the KB" means nobody owns126 anything.127- **Deprecating without checking AI and macro references.** The article vanishes from128 the help centre but still grounds answers.129- **Assuming low views means safe to delete.** Unused in conversation matching is not130 the same as unused in reality — check views and agent citations first.131- **Publishing a replacement before redirecting the old URL.** You now have two132 live answers and split traffic.133134## Present results to the user1351361. **Orphan and unowned article list**, with usage tier attached.1372. **Priority review queue** — usage × staleness ranked, not alphabetical.1383. **Proposed ownership map** — role per article or section, with gaps named.1394. **Review policy** — tier definitions, triggers, and what "done" means.1405. **Deprecation candidates** — with successor, redirect plan and reference check141 list (macros, AI, internal wiki).1426. **Governance calendar** — what runs weekly, monthly, quarterly; tied to change143 management not documentation theatre.