Revise class documentation

Change: improve wording of class documentation.