Documentation updates

The main README and firmware documentation have undergone minor
revision.  Some additional information has been added, but mostly
only typos have been corrected.