Onko uusille REST/JSON -rajapinnoille tulossa kattavaa selittävää dokumentaatiota vai onko tuon SWAGGERin ja Google Groups -keskustelujen tarkoitus olla riittävä dokumentaatio?
Esimerkiksi uusissa LAM-rajapinnoissa on mukana uutta tietoa eri sensoreista, joihin toivoisin lisää dokumentaatiota. Metadata -rajapinnoista löytyy toki jo sensorien kuvaukset, mutta osa niistä on puutteellisia (mm. yksiköt puuttuu jne.) ja varsinainen "description" -kenttä sisältää vain lyhyen kommentin.
Selittävältä dokumentaatiolta toivoisin mm. vastauksia seuraaviin kysymyksiin:
- Selkeä kuvaus sensorin tuottamasta tiedosta
- Mitä eroa sensorin tuottamalla datalla on verrattuna lähes saman nimisiin muihin sensoreihin?
- Mitä arvoja sensori voi saada?
- Perustuuko sensorin tiedot suoraan LAM-aseman tuottamiin tietoihin vai onko tiedot laskennallisia? Miten tieto lasketaan, jos se on laskennallista? Mitä muita tietoja laskentaan käytetään?