Improving documentation

This is an attempt to make content-store easier to understand from a standing start. The main focus has been:

* Consistent use of language and terminology
* Updating/deleting misleading or out of date information
* Writing the README so it makes sense to someone new to content-store
This doesn't match what the code is currently doing - it's using the private representation.