Updating documentation for new API

Also documenting the better mixin support