Add the state of this library.
Update API documentation.
Write the `README.md` file.

Reviewed by @CircleCode. Thanks!
Merge branch 'readme' into incoming