Fix of issue #528 with updated tests
linted comment
clarify what the "content" field means

this is related to #532, and should make it clear that the `content` field needs to be provided to have a prompt readable version available, and what happens if the field is not provided.
mention the willie bot extension
mention how there's a pending PR.
convert changes to rst