On the mediawiki page [[mw:Extension:Wikibase Client/Lua]], the table serialization of statement and snak functions is not explained properly. This is specially confusing for beginners, who wonder how the table they get with the statement functions is built up. Also, they do not get the serialization used for snak functions. They do not know about the json serialization ([[mw:Wikibase/DataModel/JSON]]), which is what the table contains and thus get stuck.
This was explained properly in revision [[mw:Special:Redirect/revision/915272]], not that I expect the whole serialization to be displayed on that page, but it should give an idea where I am going.
In this bug, the documentation for the following functions should answer the question of how the table that is returned is built up (in the case of the statement functions) and mention how the serialization for snaks is built up (for the snak functions). Also, there should be a prominent link to the JSON data-model. An link to the json data-model at the end, like it is currently, is not sufficient. Those two fixes is what this bug covers and nothing else.
mw.wikibase.renderSnak
mw.wikibase.formatValue
mw.wikibase.renderSnaks
mw.wikibase.formatValues
mw.wikibase.getBestStatements
mw.wikibase.getAllStatements