beefed up the handbook

Added some extra sections, some cautionary warnings, fixed some typos and beefed up on some details of other aspects.