updated some jsdoc
removed argument being optional
handle dropping (work in progress)