Work in Progress: Adding docco comments to racer

As an continuation of a https://github.com/codeparty/derby/pull/159 here is a n attempt to document racer's internals.

This pull request should be considered as a **work in progress** for which help and corrections are needed.