Updated README and docs. Merged with content that was written for the official docs.