Update notes for submitted changes

* doc: Make file headings consistent, and update docstrings per the proposed HACKING guide