document main entry points for various machine types
fix formatting
briefly describe the parsing process
brief orientation on merging
Merge pull request #2 from rdm/master

documentation update