Updated README

@ywarnier identified a critical issue in the current README, which is
* It is not current
* It is incomplete
* It assumes a lot of knowledge about the project.

This commit attempts to resolve that issue!