Create README.md for each crate, and move /docs into each crate to self-contain all documentation

[jaytaph]

Each crate should have a README.md which tells us what the crate does.

It also should have a /docs directory (per crate) where we place all documentation of the crate, preferably linked from the README.md