Just updated this guide for 2024: https://community.home-assistant.io/t/editing-the-documentation-and-creating-a-pull-request-on-github/9573 any point including it in the cookbook?
2 Likes
I don’t think it fits with the cookbook introduction paragraph. But I really like it and I do think it belongs either somewhere in the cookbook, or as a pinned topic by itself in the community guides, or both.
I think we can add a “Contribute to the project” heading and put it there. Maybe some dev guides could go there too.
4 Likes
Editing official documentation is very useful.
+1 for adding it to the cookbook.
“Getting Started With HA” contains a bit if everything.
A new section with “contribution to the project” also makes sense, but I wouldn’t mind having this particular topic more towards to community and beginner chapters.
A similar guide on how to contribute to translations would also he a good start for beginners to get involved.
Did it get added? Can’t see it. Mind you, Tom’s been busy… 
Edit: I’ve put it in the “More experienced users” section.
Edit, Edit: See below.
Good idea - done that. Can’t get the “11” right, though. The blue numbers only seem to go up to 10.
1 Like
Given the interest lately, should we have more about voice assistants?
I personally could do with a clear explanation of the difference between using a voice client (Alexa, Voice Assistant PE) and custom sentences/intents. There seem to be clear limitations on the latter (no LLMs), but with the former you can’t use existing speakers. It isn’t very well documented.
There are also several different ways of using Alexa which could be made clear. I’ve noticed one or two people conflating them and getting stuck.
A fun thing might be a comparison of the different voices available, with samples. (My personal favourite atm is “Brian” from Amazon Polly - elderly butler who has been at the sherry.
1 Like
Yeah, the “help us help you” page does the same thing you did with 11. I changed the 10 to one-zero to match the one-zero visually.
1 Like
I haven’t made any progress like I had planned, and I’ve really lost steam on the idea. As I read through what I’ve wrote, I’m starting to realize it’s not possible to achieve what I had set out to do. There’s just too many topics that I wanted to cover and it’s not possible to make it easy to read at the same time. I think having the topics split up into different posts like the cookbook already does is the best way to do this.
I’m open to anyone who wants to move the guide forward, or I’m also open to deleting it or taking any valuable pieces and moving them into other parts of the cookbook.
I know the feeling!
Leave it for a while before you delete it - someone else may be able to add to it.
Still worth doing, I think. Newcomers are always asking for this sort of thing.