Improved docs for refactoring existing classes.