doc comment updates for review