CaCO3 94a53b38b8 Update Homeassistant discovery (#3580) hai 11 meses
..
.idea 8410df6144 Move param doc (#2843) %!s(int64=2) %!d(string=hai) anos
parameter-pages 94a53b38b8 Update Homeassistant discovery (#3580) hai 11 meses
templates 8410df6144 Move param doc (#2843) %!s(int64=2) %!d(string=hai) anos
README.md 8410df6144 Move param doc (#2843) %!s(int64=2) %!d(string=hai) anos
expert-params.txt cd1165e547 IgnoreLeadingNaN fix (#3547) hai 11 meses
generate-template-param-doc-pages.py 8410df6144 Move param doc (#2843) %!s(int64=2) %!d(string=hai) anos
hidden-in-ui.txt 8410df6144 Move param doc (#2843) %!s(int64=2) %!d(string=hai) anos

README.md

Parameter Documentation

Each parameter which is listed in the configfile has its own description page in the folder parameter-pages (grouped by the config sections). Those pages can be edited as needed.

During a Github action build, those parameter pages will be used to generate the tooltips in the web interface. And they also are used to build the Online Documentation.

If you create or rename a parameter, make sure to also update its description page!

Template Generator

The script generate-template-param-doc-pages.py should be run whenever a new parameter gets added to the config file. It then checks if there is already a page for each of the parameters.

  • If no page exists yet, a templated page gets generated.
  • Existing pages do not get modified.

If the parameter is listed in expert-params.txt, an Expert warning will be shown.

If the parameter is listed in hidden-in-ui.txt, a Note will be shown.