Major refresh of README for the upcoming 1.0 release.

Not ready for merge.