more documentation
more docs - reworked intro. fixed bug in scripts/documentor.coffee where it would fail if the file comment started on line 0 like it was doing on utility.coffee.
first test on an example using jsdom