Better documentation on compiling doc

[massich]

It took me a couple attempts to compile the documentation + i've plenty sklearn future warnings.

maybe you should add a small contributing guide with instructions for quickly replicate the doc.