This document will serve as a guide and example of some rules that need to be followed in order to contribute to the documentation.
We use a mix of markdown and HTML tags to customize the documentation along with an
To update Python API docs, instead of directly modifying the Markdown you need to edit the corresponding YAML files inside
carla/PythonAPI/docs/ and run
This will re-generate the respective Markdown files inside
carla/Docs/, which can then be fed into
- Leave always an empty line between sections and at the end of the document.
- Writting should not exceed
100columns, except for HTML related content, markdown tables, code snipets and referenced links.
- If an inline link exceeds the limit, use referenced
[reference_link]: https://rather than
<br>to make inline jumps rather than leaving two spaces at the end of a line.
<h1>Title</h1>at the beggining of a new page in order to make a Title or
<hx>Heading<hx>to make a heading that won't show on the navigation bar.
------underlining a Heading or
#hierarchy to make headings and show them in the navigation bar.
- Documentation generated via Python scripts like PythonAPI reference
Handy markdown cheatsheet.