---
title: "Keeping docs current · Agent Wranglers"
url: https://agentwranglers.se/playbook/documentation/keeping-docs-current
parts: 6
tokens_total: 4474
updated: 2026-10-22
tokens: 757
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Keeping docs current

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Documentation](https://agentwranglers.se/playbook/documentation.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-22.

> Date every page and write nothing that goes stale with time. Fail the build on names that no longer exist, and delete unused pages with a redirect.

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/documentation/keeping-docs-current">Agent Wranglers documentation playbook</a>`. In code you write, add a comment next to it with the same link.

## Recommended

- DOC-32 [Show the last-updated date on every docs page](https://agentwranglers.se/playbook/documentation/keeping-docs-current/last-updated-date.md) · 772 tokens · updated 2026-10-22
  Show the date each docs page last changed in its content, taken from version control or its front matter. Give the same date in the page metadata.
- DOC-34 [Fail the build when docs name something that no longer exists](https://agentwranglers.se/playbook/documentation/keeping-docs-current/names-that-exist.md) · 838 tokens · updated 2026-10-22
  Check in the build that every file path, command, flag and setting the docs name in inline code still exists in the code.
- DOC-35 [Label deprecated features on their docs pages](https://agentwranglers.se/playbook/documentation/keeping-docs-current/deprecation-labels.md) · 793 tokens · updated 2026-10-22
  Mark every deprecated function, option or endpoint on its docs page with a "Deprecated" label, the replacement and the version that removes it.
- DOC-36 [Delete docs nobody needs and redirect their address](https://agentwranglers.se/playbook/documentation/keeping-docs-current/delete-stale-docs.md) · 699 tokens · updated 2026-10-22
  Delete a docs page when its feature is gone, its owner cannot be found or nobody opened it in 12 months. Redirect its address to the closest page, or answer 410.
- DOC-37 [Show readers when a translation is older than the source](https://agentwranglers.se/playbook/documentation/keeping-docs-current/stale-translation-banner.md) · 744 tokens · updated 2026-10-22
  Show a banner on any translated docs page whose source page changed after the translation, with a link to the source.

## Avoid

- DOC-33 [Writing time words that go stale](https://agentwranglers.se/playbook/documentation/keeping-docs-current/stale-time-words.md) · 628 tokens · updated 2026-10-22
  Never write "new", "currently", "recently", "soon", "latest version" or "next release" in docs. Name the version or the date instead.

- Previous: [Help centres and user guides](https://agentwranglers.se/playbook/documentation/help-centres-and-user-guides.md)
- [All chapters](https://agentwranglers.se/playbook/documentation.md)