In the same way a Sensor has a getParameterDescriptors() method to describe the parameters it takes, it would be useful to add a method to describe the values it returns in state extended info.
This way:
a) extended info would be more useful for users, that could then better understand what a value means.
b) implementation of services that add chart generation facilities will be easier.
I think that this description must provide at least this information:
- text string describeing what the value means
- info about what states return this value (for example, most values have no meaning in Unknown state)
- units of measurement. e.g. KB, bps, MB/s, percentage..., in case of numeric values.
Also, nested states (such as Ftp sensor welcomePatternStatus, fileStatus...) must be taken into account.