Escape HTML characters

[oandregal]

We are about to use JSDoc comment description to generate some documentation in Markdown format (and potentially others).

HTML tags need to be escaped for Markdown not to consider them HTML.

[aduth]

Generally fine with this, but it seems like the sort of thing which ought to be (a) automated by the documentation generator and/or (b) enforced via linting rules.

[oandregal]

My concern with those is that you could write HTML as markup (not as part of the contents) intentionally (see first example). Because this is the only occurrence I've found I thought about deferring the decision until it becomes an issue and fix this manually.