Revise documentation style

Change: classes are described in a slightly more abstract manner.
Change: improve wording in a few instances.