This repository holds the sources to build the deCONZ REST-API Documentation.
All source files are maintained in the master branch.
The actual documentation can be found at https://dresden-elektronik.github.io/deconz-rest-doc.
It is hosted via Github pages, with the content of the gh-pages branch.
The documentation is build with MkDocs.
The content it mostly written in Markdown files in the /docs directory.
We accept pull requests for the master branch.
To edit files locally and review the changes before creating a pull request, you need to:
- Install MkDocs as described on the projects homepage;
- Fork and checkout the
masterbranch of this repository; - Open the checked out directory and start MkDocs;
cd deconz-rest-doc
mkdocs serve
- MkDocs now starts a slim webserver on your local machine;
INFO - Building documentation...
INFO - Cleaning site directory
INFO - Documentation built in 0.72 seconds
[I 201120 20:18:17 server:335] Serving on http://127.0.0.1:8000
INFO - Serving on http://127.0.0.1:8000
[I 201120 20:18:17 handlers:62] Start watching changes
INFO - Start watching changes
[I 201120 20:18:17 handlers:64] Start detecting changes
INFO - Start detecting changes
- Open http://127.0.0.1:8000 in your browser to view the documentation output.
Note: Since MkDocs supports hot reload changes in Markdown files are updated immediately in the browser.
Once your happy with the edits, create a pull request of the master branch 🎉