Address package level comments for readability.

Done.  PTAL

Thanks!
--brendan