add pragmactic section to docs introduction
minor docs edits
massage parallelism docs