minor commenting improvements to better conform with JSDoc