minor doc and comments updates