BS-11291: add some jsdoc