add parallelism doc page

A bit rough.  Suggestions or straight out pull requests welcome.