Renamed docs -> doc.

This is apparently what the doc directory should be called... Oops...
Changed README md -> rst.

It stops distutils complaining.
Updated README following repo ownership change.
Docs: added separate reference directory.
Doc: Updated overview.
Doc: Added contributing and installation docs.
Removed unused example in docs.