Formatting updates to make revelator happy

and turn some things into code examples so it reads better.