Commit long overdue rewrite of the README.

[ci skip]