updated class docs
document events