New API docs using literate coffeescript.
Review of docs still required.
Remove percolate and docco from the node deps.
Moving around documentation files.
Move snockets to batmanjs.
Merge pull request #792 from batmanjs/upgrade_doc_generator

Upgrade doc generator