inline documentation (JSDoc), renamed vars, cleaner js