Version including peer review changes

This version integrates Kelvin Lee's comments and changes made for the publication of a manual's section as a blogpost