- NodeJS v12+
- Python 3.7+ with pip
- Install mkdocs:
pip install mkdocs
- Install mkdocs Material theme:
pip install mkdocs-material
docs - Test the mkdocs command:
mkdocs --version
- clone the repo
- run
npm install
- run
npm start
ornode index.js
this will generate the./docs/
files - run
mkdocs serve
and openlocalhost:8000
- run
mkdocs build
to generate static html in./site/
- Mkdocs generates important INFO logs (eg: missing important md files)
- Important: during development & testing use the
dump.json
method instead of getting schema from API.