This is the source repo for the Tinkerbell docs. They are build using static-site generator mkdocs and using the mkdocs-material theme, then served by netlify to docs.tinkerbell.org.
If you wish, you can install mkdocs and mkdocs-material to build the docs locally. Prerequisite: You need to have Python installed.
To install mkdocs:
pip install mkdocs
Next you'll need to install the mkdocs-material theme:
pip install mkdocs-material
To build locally, clone the repo and from tinkerbell-docs, run:
mkdocs serve
All the markdown source files for the documentation are in the docs/ folder. Find the file that you want to update and edit it. Then open a Pull Request with your changes. Make sure that the build passes, and take a look at the netlify preview to see your changes staged on the website.
Currently the metadata for the page is yaml formatted, with two fields: title and date. If you edit a doc, update the date to when you made your edits.
All the images for the docs are in the images/ folder. To pull the image into your doc, use a relative link to the image file. Example:
If you would like to submit a new page to the documentation, be sure to add it to the nav section in mkdocs.yml. This will ensure that the page appears in the table of contents.