Extracted API docs into separate file

This will play better with StrongLoop doc tooling.  Reworked heading
levels, added single-quotes around event names, plus some slight text
rewording.