Files
my-rook-config/Documentation/Contributing/documentation.md
T
2022-08-30 15:46:21 +02:00

1.5 KiB

title
title
Documentation

We are using MkDocs with the Material for MkDocs theme.

Markdown Extensions

Thanks to the MkDocs Material theme we have certain "markdown syntax extensions" available:

For a whole list of features Reference - Material for MkDocs.

Local Preview

To locally preview the documentation, you can run the following command (in the root of the repository):

make docs-preview

When previewing, now you can navigate your browser to http://127.0.0.1:8000/ to open the preview of the documentation.

!!! hint Should you encounter a command not found error while trying to preview the docs for the first time on a machine, you probably need to install the dependencies for MkDocs and extensions used.

```console
pip3 install -r build/release/requirements_docs.txt
```

Please make sure that your Python binary path is included in your `PATH`.