add jsdoc documentation + examples to every method