docs(README): update readme details

Readme updated with API description, build information and code samples.