docs and comment updates