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.