Getting set up

Note

You only need to do this if you want to play with documentation system, update or change the content and preview locally.

This project can be found at https://github.com/picklejuicedev/kedro_docs_prototype.git

Either clone or download it to a local folder.

If you want to play with the documentation locally, install the following packages:

- `mkdocs`             # core document library
- `mkdocstrings`       # used to extract `docstrings` from code
- `mkdocstring-python` # python extension for `docstrings`
- `mkdocs-gen-files`   # helper to create markdown files programatically
- `mkdocs-material`    # very nice material theme
- `mkdocs-include-markdown-plugin` # plugin to insert .md or other files into markdown files

Like this:

pip install mkdocs mkdocstrings mkdocstring-python mkdocs-gen-files mkdocs-material mkdocs-include-markdown-plugin

Kedro requirements

You don't need to run the kedro project to be able to generate the documentation. But if you want to run kedro then you also need to do the usual pip install -m src/requirements.txt.