code smell + document formatting

I added a code smell and cleaned up some messy paragraphs and
inconsistent fonts.