updated jsdocs and comments for ds