fantastic class level documentation.  :metal: