improved comments for some classes