because sometimes, jsdocs are just not enough :)