boy scout rule
(http://www.clean-code-developer.com/Red-Grade.ashx#Follow_the_Boy_Scouts_Rule_4)
added some docs and dialog