converted all the coffee scripts into literate cofee, added inline documentation
more docs