Document main public API in the code; Fixes #28
Add proper docs to README; Fixes #28.