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