# Wiki vs living documentation

> Last updated: August 2026

A traditional engineering wiki is a hand-maintained page library. Living documentation is a source-linked record that updates as PRs merge, tickets close, and decisions happen in chat, so people and AI agents share current, citable context.

## Quick answer

Choose a **wiki** when you need narrative pages that change rarely and a human editor owns every update. Choose **living, source-linked documentation** when the system of record must track a moving codebase and remain trustworthy for onboarding, on-call, and agents.

## Comparison table

| Criteria | Traditional wiki | Living / source-linked docs |
| --- | --- | --- |
| How content is created | People write and edit pages | Generated from connected work tools, then human-reviewed |
| Freshness | Decays unless someone updates it | Tracks merges, tickets, and decisions as work happens |
| Traceability | Often none or informal links | Every claim can open a PR, thread, or ticket |
| AI / agent use | Risk of answering from stale paste | Agents query the same cited record (for example over MCP) |
| Best for | Stable process prose, handbooks | Product systems that change weekly |

## When teams abandon wikis

Teams often abandon wikis because documentation fatigue sets in: writers cannot keep pages synchronized with code and Slack decisions. See [why teams abandon wikis](https://scopedocs.ai/blog/why-teams-abandon-wikis-research-on-documentation-fatigue).

## When a wiki is still useful

- Company handbook content that changes quarterly
- Long-form narrative that is not tied to a specific PR
- Public docs where humans intentionally publish a release train

## How living documentation fits with AI agents

Coding agents in Cursor, Claude Code, and ChatGPT need current project decisions, not last quarter's Confluence export. Living docs that stay source-linked let agents retrieve answers with citations humans can audit.

## Related

- [What is source-linked documentation?](https://scopedocs.ai/guides/what-is-source-linked-documentation.md)
- [ScopeDocs product](https://scopedocs.ai/product.md)
- [llms.txt](https://scopedocs.ai/llms.txt)