Expose the 'rich_text' field for reading in the API, and doc it.

Clients using the API had no idea whether the text contents for various
resources were in plain text or Markdown. We now expose the rich_text
field for these resources, and document it in the resource description.