Clean up documentation headings globally in parent package

[benwandrew]

Description

• resolves #482

Type of change

• docs: Documentation only changes

[benwandrew]

Looks good! We should have stuff like this documented somewhere as style guide (I think under contributions makes sense)

good idea, just created a small PR to add this in index.md under contribute