Document result dictionaries "automatically"
I consider the general documentation (#16) to be finished with #95.
However, there is one more thing people are requesting: to know what the result dictionary includes exactly. This is something python-musicbrainz2 provided, since documented objects were returned, rather than transparent dicts.
This is a general problem with the web service. A documentation of the results there would be enough, but isn't available. There is some work on this in http://tickets.musicbrainz.org/browse/MBS-5307.
Like I already mentioned in https://github.com/alastair/python-musicbrainz-ngs/issues/16#issuecomment-16513380, this would be possible with internal restructuring of the parsing code. We could pull this information out of a dictionary then and create a documentation out of that. However, that is quite a bit of work.