Revise class documentation

Change: improve wording for documentation of various classes.