Update docs; make pages.yml optional

Add usage and examples to the documention.

Check to see if the pages override file (pages.yml) exists before
attempting to parse it, since it is optional.