Jump to content

SRE/Data Persistence/Documentation guidelines

From Wikitech
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

General guidelines

  • If you notice a mistake / gap requiring a simple update, JUST DO IT™.
  • If you notice a mistake / gap requiring a non-trivial update, add the documentation review include.
  • Keep the documentation pages as short as possible. Any self-contained section should be its own page.
  • If you realize we need to document something but don't have the time to do it, create a stub page with a short description and the documentation review and footer includes.

Includes

Documentation review (pages requiring comprehensive review)

Add the following at the top of the page: {{SRE/Data Persistence/Documentation_review}}

Add the following at the bottom of the page: {{SRE/Data Persistence/Footer}}

Special pages