-
-
Notifications
You must be signed in to change notification settings - Fork 7.6k
No list of available oconfiguration.yaml options #37795
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
Those are thousands of configuration options. I get what you are saying, but there is no sane way to create a single page for that. Additionally, options are part of integrations. In this specific case, I think you mean setting up TLS for the HTTP integration? Or..? ../Frenck |
I think my main concerned can be boiled down to navigation. Even if you navigate to the integrations list, and it's only mentioned in the configuration.yaml page, not linked directly, you have to know that the correct integration is called "HTTP" in order to find the options you are looking for, it's opaque until you already know what you want to use. I understand it would be nearly impossible to maintain a list of all options for all potential integrations, but for "built-in" functionality that is natively a part of home assistant, I would expect to find a unified list of integrations at the least. Rather than having to sift through 3000+ 3rd party integrations to find what is part of the core feature set, it seems reasonable that those core integrations should be called out separately. I would also point to documentation set up in a format like the following: Formatted as a reference book, where it is easy to navigate through various modules and see all potential options. It is also fairly common practice that these documents are generated programmatically during builds so the reference book is always a full skeleton, even if a human has not gone through to flesh out the documentation beyond "be aware this option exists". |
There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved. |
Feedback
Finding options for something as simple as enabling TLS requires looking up multiple pages across multiple websites, some out of date and conflicting. Having a list of all available configuration options seems like it should be a priority in documentation and HA doesn't seem to have that first-party anywhere.
URL
https://www.home-assistant.io/docs/configuration/
Version
2025.2.5
Additional information
No response
The text was updated successfully, but these errors were encountered: