Expand upon some of the API resource descriptions.
The descriptions for some of our main API resources were pretty thin.

This expands upon them just a bit. Largely, it's in preparation for

further edits to these particular descriptions that are coming in

another change.