move all markdown blocks out of control.js. refactor inline comments to comply with the stated styles more effectively. (#756)