DOC add learning_curve to what's new and API reference

+ PEP8 fixes

+ Alphabetical ordering fix for classes.rst

+ Example reference