doc comment tweaks and improvements