Set up regular content reviews
Make it easier to keep documentation up to date by configuring the page expiry notifier, Daniel the Manual Spaniel.
How it works
Daniel the Manual Spaniel checks for pages that are due for review. It looks at the review_by dates in your /api/pages.json file, which is generated when you build your documentation.
The Tech Docs Template calculates review_by from the page expiry parameters you set in the page frontmatter.
When review_by is in the past, the page is due for review, and Daniel the Manual Spaniel sends a Slack notification to the page owner:
The page owner can be a Slack group or a Slack user. You can configure owners for:
- the whole documentation site by editing the
config/tech-docs.ymlfile - individual pages by editing the page frontmatter
When defining the owners, frontmatter configuration overrides global configuration.
Daniel the Manual Spaniel will continue notifying the page owner every weekday until review_by is in the future.
Requirements
For Daniel the Manual Spaniel to be able to scan your documentation you must set:
- page expiry parameters in the frontmatter
- owners for your documentation
Set up the page expiry notifier
There’s guidance on setting up Daniel the Manual Spaniel to scan your documentation in the alphagov/tech-docs-monitor GitHub repo.
See an example pull request to set up Daniel the Manual Spaniel.