Table of contents


Review a page in this manual

We have a system to make sure we regularly review pages in the manual.

Main pages in the manual are reviewed every 3-12 months, mostly by the 2nd line team.

We also document Icinga alerts. These explain what to do when a certain alert triggers (example). Because these can be very rare and hard to review, we should review these around the same time every six months. This is best done by people with a lot of 2nd line context. To make sure we’ve documented all alerts, you can run rake lint_alert_docs in govuk-puppet, which will output alerts that can be removed/need to be added.

How to review

Things to look out for

  • Is the page accurate?
  • Is the page still relevant?
  • Does it help the reader complete their task?
  • Does it follow the styleguide?

When you’ve reviewed the page, either:

  • Update the page
  • Remove it (don’t forget to set up a redirect)
  • Assign it for someone else to review
  • Confirm the page is OK and set a new review date

These tasks can be achieved by editing the metadata at the top of the source for that page. See the govuk-developer-docs github repo.

Choose a review by date

  • How likely is it that the information will change?
  • Is work happening in this area?
  • What would the impact be if the information were wrong?

Is there a relevant blog post to the page you’re reviewing? Would linking to it help the reader complete their task?

You can find GOV.UK blog posts on the GDS Tech blog.

This page was last reviewed on 3 January 2019. It needs to be reviewed again on 3 January 2020 by the page owner #govuk-developers .
This page was set to be reviewed before 3 January 2020 by the page owner #govuk-developers. This might mean the content is out of date.