Update intro and usage documentation

First pass at updating the documentation. Kept the changes limited to the intro and the usage sections.

More to come -- if this is helpful.