You are browsing a read-only backup copy of Wikitech. The primary site can be found at wikitech.wikimedia.org

Difference between revisions of "SRE/Data Persistence/Documentation guidelines"

From Wikitech-static
Jump to navigation Jump to search
imported>LSobanski
 
imported>LSobanski
 
Line 21: Line 21:


{{SRE/Data Persistence/Footer}}
{{SRE/Data Persistence/Footer}}
[[Category:Data Persistence]]

Latest revision as of 09:42, 9 June 2021

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}}

Footer (all pages)

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

Special pages



This page is a part of the SRE Data Persistence technical documentation
(go here for a list of all our pages)