Source of https://itpp.dev/ops/ docs

How to contribute to docs

Initialization

• Fork this repo

• Clone to your machine

• Install dependencies:

  sudo pip install sphinx sphinx-autobuild
  sudo pip install sphinx_rtd_theme
  

Contribution

• Edit files in the repo. Check documentations:

  • http://www.sphinx-doc.org/en/stable/rest.html
  • http://www.sphinx-doc.org/en/stable/domains.html
  • http://www.sphinx-doc.org/en/stable/markup/index.html
  • images.md

• Try it out:

  cd /path/to/odoo-devops/docs
  make html
  
  # (check warningn and errors in compilation logs and fix them if needed)
  
  # open result
  google-chrome _build/html/index.html
  

• Make commits, push, create Pull Request