Adding all this documentation makes me really happy :D

If you're in a documenting mood, the [wiki](https://github.com/share/ShareJS/wiki) would probably be a better place for a lot of this content, and really needs some love. I'd love this content put there.

Editing is open, though I don't get notifications when you make changes.