Document the steps needed to update a MR module

Plus some incidental whitespace cleanup.

Addresses #1215 
but -> while