Updated text in README and API docs

@jdimond - please review and merge