doc tweaks
clean up parallelism specification (in prep for possibly not using all CPUs, add version field to build, tweak various docs...)