3.2 typos and minor editorial changes

[ralfhandl]

• schema changes are included in this pull request
• schema changes are needed for this pull request but not done yet
• no schema changes are needed for this pull request

[mikekistler]

Looks good! 👍

[handrews]

@ralfhandl I really, really appreciate your thorough read-through here. I have some minor quibbles and questions, but nothing major and nothing I feel so strongly about as to really dig in if other folks are fine with it.

[ralfhandl]

@handrews Let's discuss your questions, please comment on the changes you don't fully agree with.

[handrews]

@ralfhandl

@handrews Let's discuss your questions, please comment on the changes you don't fully agree with.

I think most things are now fine. I replied to the markdownlint section header problem elsewhere

That depends whether the media type mentioned in the comment is a field name or a field value.

There's also just using a media type as a media type regardless of its position. But in all three cases, it should be in backticks, just possibly also in quotes. I think. Like this:

• Field name: text/event-stream
• Field value: "text/event-stream"
• Media type, regardless of position (or position ambiguous): text/event-stream

[ralfhandl]

@mikekistler Could you please re-approve?

[mikekistler]

Re-approving.