Adding some docs, few method changes

Changed some signatures to deal with the return types of different query actions in different datastores. See the differences in the Key type param of the datastore.
Removed the putRaw method.

Replaced with a freshEntity(clazz) method and constructing a writer and storing it using existing methods. A lot less clunky IMO.