PagerDuty Business Incident Response Documentation
This is a public version of the Business Incident Response process used at PagerDuty. Business Incident Response is a an application of PagerDuty’s Incident Response framework for non-technical response to mitigating business impact from severe technical incidents. This guide focuses on the business operations that should occur in parallel, while technical responders work to resolve severe technical incidents.
See the about page for more information on what this documentation is and why it exists.
You can view the documentation directly in this repository, or rendered as a website at https://business-response.pagerduty.com.
We use MkDocs to create a static site from this repository. For local development,
- Install v0.1.0 of MkDocs Bootswatch
pip install mkdocs-bootswatch==0.1.0
- Install v0.1.1 of MkDocs Bootstrap
pip install mkdocs-bootstrap==0.1.1
- Install v0.15.3 of MkDocs.
pip install mkdocs==0.15.3
- Install v0.2.4 of the MkDocs Material theme.
pip install mkdocs-material==0.2.4
- Install MkDocs PyMdown Extensions.
pip install pymdown-extensions
- To test locally, run
mkdocs servefrom the project directory.
From the root directory of this repo...
docker build -t mkdocs .
docker run -v `pwd`:/docs/ -p 8080:8080 mkdocs
http://localhost:8080to see changes in your browser
mkdocs build --cleanto produce the static site for upload.
sitedirectory to S3 (or wherever you would like it to be hosted).
aws s3 sync ./site/ s3://[BUCKET_NAME] \ --acl public-read \ --exclude "*.py*" \ --delete
Thank you for considering contributing! If you have any questions, just ask - or submit your issue or pull request anyway. The worst that can happen is we'll politely ask you to change something. We appreciate all friendly contributions.
Here is our preferred process for submitting a pull request,
- Fork it ( https://github.com/PagerDuty/business-response-docs/fork )
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create a new Pull Request.