Update docs contribution guide

[hamishwillee]

This does lots of minor fixes/updates. The reason for doing this is to mention prettier formatting and line breaks.

[github-actions[bot]]

No flaws found