A frustration which I think a lot of people share is with HA documentation. We are urged to read the docs and they really are extensive and helpful, but they can also be very hard to navigate.
I have created an A-Z index which I hope people will find useful occasionally - particularly perhaps newcomers. Nothing original here, just a collection of links, but a-z is second nature to everyone.
Updating
Currently being updated once a month (shortly after each new release). This includes a broken link check. Where possible, links are to pages rather than anchors within pages, so they should not be affected by changes to the content of the documentation.
There are bound to be omissions - please let me know if anything needs adding.
Note: the index does not include links to vendor- and device-specific implementations. Home Assistant have their own index here.
Post the index in the official documentation (as opposed to where itās now, on some external site). More users are likely to benefit from the index if itās part of the documentation.
Hi Jack, welcome to the forum!
Nice work, this can be useful and as Taras says: by placing it in the official documentation more people will benefit from it.
Have you seen this on the bottom of the documentation pages:
This was deliberate to make it clear the page was unofficial. Iām revising it to get rid of all the buttons (which are a pain to update) but the colour scheme is staying the same.
Too right! Iām trying to make all the links to pages, rather than anchors within pages, on the assumption that the structure of the docs will change less often than the content. But itās still a problem.
Do you have experience with Github? If so, why donāt you fork the documentation from the HA repo and change it like you want? The documentation is licensed to share and modify, as long as the copyright notices and the license remain intact, and it is not for commercial use, ie. you arenāt allowed to sell a new or reworked documentation.
But anything else, is totally ok.
If you want to do it and donāt know how, Iām happy to help you setting up a fork in your Github repo and give you a little initial aid.
EDIT:
On further thinking, that could be kind of a cool project to setup. You could fork the repo and rework the documentation on as many places you want (even if itās āonlyā the index!). Afterwards you could host and even publish it, so people could choose between your and the original documentation.
And as the repos are connected via the fork, you could easily import every change in the original documentation to your fork and if necessary, change it to fit your design and ordering. Sounds nice, and doesnāt even cost a thingā¦
At the moment Iām working with a sitemap, and as I said above, linking to pages rather than content. Apart from anything else, theyāre not my docs to mess with.
This is obviously not sustainable though - and youāre right, it would be a cool project. Can I get back to you?
Iām trying to make all the links to pages, rather than anchors within pages, on the assumption that the structure of the docs will change less often than the content. But itās still a problem.
