minor content tweaks

content revisions according to the punch list doc