DOC: reorganise examples
DOC: tweak example titles
Use auto_examples in image target for consistency
Fix broken links after examples reorganisation
Add links to documentation in examples section
Merge pull request #308 from lesteve/reorganise-examples

[MRG] Reorganise examples