scikit-learn/scikit-learn — pull request #472 by GaelVaroquaux (2011-12-18 12:48:54+00:00)
Title: WIP: merge in statistical learning tutorial

The goal of this pull request is to merge in the statistical learning tutorial into the main documentation.

The pros would be:

* To make the tutorial more easily maintainable
* To be able to link from the tutorial to the docs, and vice-versa
* To have examples and images shared between the docs and the tutorial
* To make the tutorial more visible.

The tutorial should be clearly advertise as a tutorial, with a specific focus (using the scikit for inference and feature discovery more than simple prediction). It should not replace the docs and be kept short. There should be room for other tutorials with other focuses. For instance, @ogrisel's tutorial should be merged in later on.

Right now this pull request it not ready at all to be merged. I am putting it up so that people can pitch in, for instance @Balu-Varanasi, or @amuller have expressed interested. There is a lot of work. Specifically (in order of priority and difficulty):

* The index.rst should be added in the tutorial
* I do not want any images stored in the git tree: as a result I have removed some images necessary to build to avoid polluting the tree. These should all be generated by the Python code in the examples, following the rest of the scikit documentation
* I have created a examples/tutorial folder to host these examples, but each one should be moved in the right example folder and this folder should be deleted. Also, redundant examples should be deleted or merged.
* The tutorial needs to be fully doctested. I believe that this is the case currently, but the doctests take way too long to run, partly because of the model selection part (grid search). This model selection part is important, as it is important to teach it to people, but we'll need to figure out way to make it run faster: simpler data on some of these, and delegating the more complexes ones to examples that get ran only once in a while, and using 'literalinclude' directives to show the code in the docs.

What we be great is if we could iterate on the above todo list and update it as we go. For the sake of simplicity, I can give right permissions to me repo to people working on this.