added some jsdoc style documentation to files