What I really miss from the official docs is a reference. Something that lists all endpoint sand gives a pseudo-BNF schema overview. With the current docs, seeing all the possible permutations possible within the JSON structure is left as an exercise for the reader; it really requires reading the descriptions of the APIs very closely.