Both the docs and README.md contain a lot of the same information. They should be combined or one should be generated from the other.