REST API Documentation

Closed the previous pull request.  This one addresses several of the issues that @cberner found in the last one.  Bring on the feedback.