add some JSDocs