- NodeJS v12+
- Python 3.7+ with pip
- Install mkdocs:
pip install mkdocs - Install mkdocs Material theme:
pip install mkdocs-materialdocs - Test the mkdocs command:
mkdocs --version
- clone the repo
- run
npm install - run
npm startornode index.jsthis will generate the./docs/files - run
mkdocs serveand openlocalhost:8000 - run
mkdocs buildto generate static html in./site/
- Mkdocs generates important INFO logs (eg: missing important md files)
- Important: during development & testing use the
dump.jsonmethod instead of getting schema from API.