Fix references, clarify pronouns, enforce `Aside` syntax

- references to other sections in style guide aren't formatted as links
- clarify pronouns when referring to entities (he/she VS they)
- only use `Aside` for warnings