Improved some wording and examples in class docs