Skip to content

docs: add documentation audit runbook#176

Merged
mrhillsman merged 1 commit into
mainfrom
docs/documentation-audit-runbook
Jun 1, 2026
Merged

docs: add documentation audit runbook#176
mrhillsman merged 1 commit into
mainfrom
docs/documentation-audit-runbook

Conversation

@mrhillsman

Copy link
Copy Markdown
Contributor

Add docs/documentation-audit.md with a repeatable workflow for checking documentation against the codebase after structural changes. Includes:

  • Table mapping each doc to its code cross-references
  • Shell commands for checking versions, flags, interfaces, packages
  • Common drift patterns table (which code changes break which docs)
  • Step-by-step workflow from detection through issue filing to fix

Link from docs/README.md under the Contributor section.

Add docs/documentation-audit.md with a repeatable workflow for checking
documentation against the codebase after structural changes. Includes:

- Table mapping each doc to its code cross-references
- Shell commands for checking versions, flags, interfaces, packages
- Common drift patterns table (which code changes break which docs)
- Step-by-step workflow from detection through issue filing to fix

Link from docs/README.md under the Contributor section.

Signed-off-by: Melvin Hillsman <mhillsma@redhat.com>
@exe-prow-github-app
exe-prow-github-app Bot requested a review from OchiengEd June 1, 2026 17:37
@exe-prow-github-app

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: mrhillsman

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@exe-prow-github-app exe-prow-github-app Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jun 1, 2026
@mrhillsman
mrhillsman removed the request for review from OchiengEd June 1, 2026 17:37
@mrhillsman
mrhillsman merged commit d32f2d7 into main Jun 1, 2026
2 of 3 checks passed
@mrhillsman
mrhillsman deleted the docs/documentation-audit-runbook branch June 1, 2026 18:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant