tweaking inline docs while waiting for coffee… http://make.wordpress.org/core/handbook/inline-documentation-standards/php-documentation-standards/#what-should-be-documented