tidied the docs to remove dummy metadata from the front of the docs and ...

...to consistently start from h2 or greater numbers for headings