fix header metadata.

`title` should contain the text of the first heading on the page.
tiny whitespace and nesting fixes.
our tutorial has a bit different goals.
use dashes consistently in filenames.
move the headings/nestedness around a bit.
merge branch 'cosmetics' into gh-pages.