Last modified: 2014-05-01 20:08:04 UTC
We currently document the structure of data values on Special:ListDatatypes. While this is better than nothing, it's really misleading, and missing important information. It's also nearly impossible to discover. The relevant help page (or special page) should be linked from the API's self documentation, and from the relevant error messages shown to the user. The documentation on Special:ListDatatypes should include, for each data type: * Supported plain string representations (this info must be supplied be the parser). This is the relevant information for people interacting with the UI directly. * The data value type, and the JSON structure used to represent the data value. * Semantics of the individual fields of the JSON structure. * Constraints imposed by the data value's validators (should be provided by the data type factory).