added some JSDoc3 headers
started working on documentation