Documentation
The documentation site for HACS is build with mkdocs-material and hosted on Cloudflare Pages
Contribute to the documentation¶
There are two ways of contributing to the documentation:
- Using the "Edit this page on GitHub" link at the bottom of every page.
- Locally.
All changes to the documentation should go against the experimental
branch.
The repository for the documentation is hosted @ https://github.com/hacs/documentation
Edit this page on GitHub¶
When you see something that needs changing when you browse the documentation, scroll down to the bottom of the page you are looking at, and click the "Edit this page on GitHub" button in the "Help us to improve the documentation" section.
This will take you to the GitHub page for it so you can change the content.
Locally¶
First spin up the devcontainer
When you have that running issue the following commands:
You have now started a local webserver that hosts the documentation on http://localhost:8000
That server will reload if you do changes to the documentation so you can live see how the changes look.
When you are happy with the result, push the changes to your fork and create a PR to have it merged to the HACS base.
Contents¶
All pages for the HACS documentation is located under:
All images for the HACS documentation is located under:
Contents linking¶
Reference another page¶
Lets say you need to reference another page that is located under:
Then you need to use:Reference images¶
Lets say you need to reference an image that is located under:
Then you need to use:New pages¶
- Create a new
.md
file undersource/docs/
in a sub-directory that fits the purpose of the file. - Add a reference to that file in
mkdocs.yml
At the top of all pages you should have this:
---
title: A Title for the page, this will also be used in the sidebar, ie. Feature
description: "A nice description here"
---
Help us to improve the documentation
Suggest an edit to this page, or provide/view feedback for this page.