Documentation build invalid link in build system error ... and how to specify integer or float type in documentation

Development
#1

Hi,

I want to specify ‘numeric’ or ‘float|integer’ in the documentation for a new feature.

I got this error on the automated tests:
Liquid Exception: Configuration type ‘integer or float’ for key ‘min_value’ is not a valid type in the documentation. See: https://developers.home-assistant.io/docs/en/documentation_create_page.html#configuration in…

Unfortunately that page does not exist.

I searched for render_config_vars but could not find that in the homeassistant source.

Where should I look/ how can I specify a type of integer|float

Thanks

#2

I think you just specify float In that case as the set of floating point numbers includes the integers.

#3

Float is a superset of integer, yes, but in this case the plugin has special handling for integer and maintaining integer types, so it is different as I should indicate that type(float) and type(int) are supported

#4

The user does not need to know that though. If you specify it as float they can enter 4.5 or 4. It makes no difference to them. Have a look at some of the other docs, like input number. That can take both float and int but only float is specified.

#5

ok, thanks. I will follow that then.
BTW … can you let somebody know that the link in the build error is wrong?
I have no idea where the source for it is, and what the correct link should be
Liquid Exception: Configuration type ‘integer or float’ for key ‘nn’ is not a valid type in the documentation. See: https://developers.home-assistant.io/docs/en/documentation_create_page.html#configuration in…

#6

You can report the broken link here: