Minor improvements to docs readme

- Simpler section headers

- Switch inline links to reference links

- Remove text that wasn't adding much value

[skip ci]