Minor doc fixes and rename "well?" to something more descriptive.
Merge pull request #7 from cgay/docs

Minor doc changes.