1.8 KiB
Documentation
We use mkdocs with the material theme to write these docs. Whenever you make any changes, just push them back to the repo and the documentation will be deployed automatically.
Set up development environment
- Make sure your conda environment is active
pip install mkdocs
pip install mkdocs-material
Preview
Run the following command in RAPIDS root folder and go to http://127.0.0.1:8000:
mkdocs serve
File Structure
The documentation config file is /mkdocs.yml
, if you are adding new .md
files to the docs modify the nav
attribute at the bottom of that file. You can use the hierarchy there to find all the files that appear in the documentation.
Reference
Check this page to get familiar with the different visual elements we can use in the docs (admonitions, code blocks, tables, etc.) You can also refer to /docs/setup/installation.md
and /docs/setup/configuration.md
to see practical examples of these elements.
!!! hint
Any links to internal pages should be relative to the current page. For example, any link from this page (documentation) which is inside ./developers
should begin with ../
to go one folder level up like:
md [mylink](../setup/installation.md)
Extras
You can insert emojis using this syntax :[SOURCE]-[ICON_NAME]
from the following sources:
- https://materialdesignicons.com/
- https://fontawesome.com/icons/tasks?style=solid
- https://primer.style/octicons/
You can use this page to create markdown tables more easily