Notes are pretty heavy in the rendered docs, this could be more readable as regular text.

Same comment for the warning below.