Major documentation overhaul

Simplified the main README.md, moving much of its content to other
places.

I took as inspiration the documentation structure for the [numpy
repository](https://github.com/numpy/numpy)

I also added a "Guide for contributors" that includes a history of the
repository to clarify things for them.