doc-maintenance
Keep project docs aligned with recent code and feature changes — detect drift, update affected pages, and add release-relevant notes without rewriting unchanged sections.
Target: Software development & testing. Automatically collected · unverified.
Excerpt from the author’s documentation
Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.
Read the original English text
Topics in the source
- Doc Maintenance
- When to use
- When not to use
- The pass
- Style baseline
- Drift detection
- Release-note rules
- Anti-patterns
Keep the documentation honest with minimum churn. The goal is alignment between docs and behavior, not stylistic rewrites or cosmetic re-organization. Reviewers should be able to read a diff and see "this updates docs to match recent behavior changes". A PR or recent set of merges changed user-visible behavior: CLI flags, API shapes, default values, configuration keys, endpoints, environment variables, supported versions. A user-reported bug traced back to outdated documentation. A release is being cut and the docs need a pass against the merged commits. A new feature shipped but only the engineer's PR description describes how to use it. The change is internal-only (private helper rename, refactor) with no user-visible impact. You want to "improve the docs" without a behavior anchor. That is a separate scoped project, not maintenance — make a plan first. 1. Establish the baseline. Get the commit range you are documenting against (since last release tag, since last merged-doc commit, or since a specific PR). 2. Enumerate user-visible changes. Read commits and PR descriptions. List, for each change, what a user can now do differently. 3. Map changes to docs. For each change, find ev
This is an excerpt. Refer to the complete source and its current requirements.
- Source repository
- paperclipai/paperclip
- Source file
- packages/skills-catalog/catalog/bundled/docs/doc-maintenance/SKILL.md
- Fixed revision
- 1ca3e8ea2a759e511ab2d2659339c6c770a7a2ba
Sources and evidence
This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.
Author: paperclipai/paperclip · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-10T02:01:27.365Z.
Categories are inferred from names, descriptions and paths. They do not establish compatibility.
License and attribution
MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.
Original license ↗Synchronization, copying and user-reported success do not mark a resource as runtime-tested.
Limitations and notes
- Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.