Add a stub for a section to explain the new pointyhat configuation files.
While here, reformat the introduction, and add some other notes.