Where the heck should documentation for integrations end-user usage be hosted/posted/maintained?
Could each integration usage information for end-users not be documented in a web-wiki or similar?
MQTT and Z-Wave are currently the only integrations that are (somewhat) documented here for HA:
The documentations for those integrations are currently only hosted in a standard repository on GiHub:
By usage information I mean for example, technology explanations, use case scenarios, device guides, best-practices, tips and troubleshooting issues with RF-range issues in different environments, etc. and not just basic installation setup. Similar to the existing Z-Wave docs at https://www.home-assistant.io/docs/z-wave/ which is not all on one page but instead have several sub-pages which each cover more in-depth details about specific areas.
Should we submit docs for other integrations not documented there, such as for example ZHA docs?
I know that the core team don’t wish us to flood integrations page with too much text about usage, like:
Personally I would prefer to edit/write on a web-based wiki instead of only keeping docs in a repository.
A tip is that GitHub wikis can also be maintained as source code via git just as any repository.
So with that solution a wiki can also be maintained as source code on GitHub via git by developers too.
The main benefit with a wiki is that it makes it much easier for non-devs to contribute documentation.