A lot of truth there (do I detect the voice of bitter experience? ), but a very broad generalization. Some HA developers do manage it. A few HACS integrations have good documentation - Entity Controller, for example, where the developer uses MkDocs to create a very clear navigational structure.
Looking at the Home Assistant docs, the root pages are similarly quite clear, with a well thought out list of related topics in the side panel. This falls apart in the integration pages, where the side panels don’t contain links to other topics at all.
How can we improve this?
Sure enough, in the Community Guides there is a wiki on how to edit documentation…
), but a very broad generalization. Some HA developers do manage it. A few HACS integrations have good documentation - Entity Controller, for example, where the developer uses MkDocs to create a very clear navigational structure.