doc and comment tweaks [ci skip]