Keeping documentation up to date automatically
Documentation automation with gh-aw means running an agent on a schedule or after code changes so it can detect drift between code and docs, prepare updates, and propose them as a pull request. gh-aw keeps the agent inside a controlled workflow and uses a safe output to turn proposed documentation changes into a reviewable PR.
Install the starter with gh aw add-wizard githubnext/agentics/docs-updater.
---on: schedule: weekly
permissions: contents: read pull-requests: read
safe-outputs: create-pull-request: branch: docs/automation title-prefix: "[docs] " draft: true---
# Documentation Updater
Review code and documentation changes from the last seven days.
Identify outdated setup steps, missing option descriptions, and examples that no longer match current behavior. Update the relevant documentation files and open a draft pull request describing the changes and any areas that still require human review.create-pull-request matters for security because the agent does not push directly to the default branch. gh-aw validates the proposed changes and opens a pull request for human review, which keeps documentation updates reviewable before merge.