added comments and minor code maintainability

code is, so far, commented. explaining (and teaching node.js)
everything anyone should know when reading it 10 year in the future.