documentation

copy edits, new 'miscellaneous' section