update some comments to use the embedded document style

arbitrary change, more for learning purposes.