I have seen a number of people complain about the documentation at https://home-assistant.io/ (HA site). Great news! Everyone can edit it and provide improvements to the documentation. Next thing I likely see is that people don’t know how to create a pull request on Github. Great news! Here is a tutorial on how to do it.
First go to https://github.com/ and sign up for an account. Its quick free and easy. If there is a need for a tutorial for this to please post that feedback below. Otherwise sign up and sign in.
In the upper right of most of the pages on the HA site there is a “Edit this page on GitHub” link.
When you click that link you will be brought to a new page with contents of the page you wanted to edit. In the upper right there is a pencil icon, click it to edit the page.
On the resulting page you can edit the text. Use the existing content and reference the existing page for figuring out how to edit the content. Usually the page just needs some tweaking so you don’t need to start over, just add on or delete some text. I have no idea how to create a page from scratch, but I have submitted 2-3 requests that are now in place with little issue. Don’t get hung up that it will be to complicated or you don’t know how to create the formatting, its easy.
If your making a small change don’t worry about the standards, follow the precedent on the page and make the correction. If your making a large change/new page be sure to read the devloper docs before getting started. Link Below.
Here I provided some updates to the page (removing highlighted text). I provided a quick title for the pull request and added my reasoning below. When you are done, click “Propose file change”
On the next page, click “Create Pull Request”
On the next page add any additional comments and if related to a pull request on the actual Home Assistant code (not the web page) add the info and click “Create Pull Request”
You’re Done!!! You just submitted your first pull request and contributed to improving HA!
If this is your first time submitting you likely will need to sign the CLA. This is easy to do and you will either brought straight to it or receive an e-mail to complete this step. Its as simple as reading and clicking another box.
From here you will get an e-mail stating that your pull request was submitted and it will identify some reviewers based on who has worked on the page in the past. You will continue to get e-mails with updates on the status as needed. Eventually you will get one that it has been merged and your changes will go live sometime after.