Hey! I don’t understand anything in the documentation. And I mean it. It is written without good examples. I have no clue what I am doing. Every problem I had so far couldn’t be answered for me by looking into the docs. And most sutff in the forum is also not 100% possible to recreate due to the ra…

Not true. When I click on history there are changes that have nothing to do with the yaml doc.

A commit can change multiple files, iif you open one of them, it shows you the change to that document (and others if they are) look at the links Lueeus gave about how github works

[image] kanga_who: Would it perhaps be a good idea for 0.116.x, similar to 0.115.x, to be delayed a few weeks and some time invested in a road map and timeline for documentation updates? Maybe getting some feedback from the community on which areas need the most attention? Just a thought. I d…

[image] SeanM: Just like we have the “month of WTH” going on right now, it would be nice to have an annual “month of Docs” or something. Teach people how to contribute to the docs, come up with a list of focus areas and some type of “style guidelines” so that everyone is on the same page, and th…

[image] SeanM: Teach people how to contribute to the docs This. Is what’s missing.

Have you seen this? [image] Editing the Documentation and Creating a Pull Request on Github Community Guides 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…

Bill- I also come from a long history of controlled documents. I remember the gnashing of (engineer’s) teeth when the company decided we had to be ISO-9000 compliant. But, I really don’t see a need for document control of the documentation. Most people don’t run old versions of HA. If they are, t…

I don’t run old versions. Would I do try are still supported integrations. They are new to me and I just want to make sure the documentation is still applicable.

[image] ludeeus: Have you seen this? You are completely missing the point. Totally. So, the documentation is written in an obscure markup language named Markdown. Markdown is a Perl script running on a Linux Server using a front-end called Movable Type. Or SmartyPants. Or Bloxom. Or BBEdit…

[image] stevemann: So, the documentation is written in an obscure markup language named Markdown. Not really that obscure, and it has to be written in something - what do you suggest?

Beginner friendly documentation

Feature Requests

ludeeus (Ludeeus) September 11, 2020, 12:46pm 80

Have you seen this?