Rewrite docs to reflect API changes for 1.x.x

[mtimofiiv]

People need to know what the hell they're dealing with here

[mtimofiiv]

Full re-write of docs (to make them actually useful) is in progress. Since the API changed as much as it did from the 0.x.x to 1.x.x versions, the old docs being up were doing more harm than good since they were wrong!