Updated readme with API docs & philosophy. Fixes #1