Reorganize documentation

[rouille]

• create a docs folder
• split current README into small rst files
• create a toctree
• write succinct README for the repository as pandas does

[danielolsen]

We will also want to re-structure the example code based on #420.