Portal:Data Services/Admin/Runbooks/Runbook template

From Wikitech
Jump to navigation Jump to search

This is a template for Data Services runbooks.


Admin permissions header

If your runbook requires admin permissions to complete, include this header (hint, it probably will in this section):

The procedures in this runbook require admin permissions to complete.

Note: if your runbook is intended for general users, and also has some steps that require admin permissions, you should mark those steps with the following template, so folks can easily identify what they are able to do: Requires admin permissions

Error / Incident


Provide a description of the error or incident.



Provide a solution, detailed list of steps a person will need to follow to fix the error.

Support contacts


You may choose to list support contacts, individuals who have knowledge about this topc and who may be able to confirm the accuracy of the runbook or who may can help resolve issues related to the error or incident.

Note: Including the template {{:Help:Cloud Services communication}} may be sufficient.

Related information


Provide links to related tools, tickets of previous incidents, and documentation that may provide context or additional information.

What else to include

  • Diagrams