Contribute to the Handbook

You need to clone the ec-internal-jira container to contribute to the Developer Handbook

The container should automatically stop the MySQL and Jira systemd services when you start it thanks to some code in ~/mkDocs/home/ec/mkDocs/bashrc.inc.bash

MkDocs

We are using MkDocs along with the Material for MkDocs theme.

Cache Busting CSS

To cache bust your CSS you can add a query parameter to the end of your theme overrides CSS in the mkdocs.yml file.

1
2
3
# Custom Styling
extra_css:
  - 'stylesheets/extra.css?v=2017-12-22'