Added some API example, both in code and in README.adoc
Added explanation section on the current work and milestone targets
Linked straight to code in github
Merge pull request #124 from alexsnaps/Doc

Added some API example, both in code and in README.adoc
Fixed relative links to work on github
Got rid of relative links

but for the "forward only pointing" one
more key/value type checks
added test for new key/value type checks. filled out SPI tests for
Store.computeXXX() methods