docs: Improve descriptions of the public API's class, methods, and parameters. (EDU-2461) (#240)

* javadoc edits

* docs: Add and format descriptions of the public API's class, methods, and parameters. Provide missing descriptions and make the wording consistent with readme.io.

* stylistic edits per Jennifer Black

Author: jamesneimanconsulting