improved documentation of classes