Updated README and API docs

@jdimond - please review and merge.