Documentation should also be in the repository (to keep in sync with versions)

[Ocramius]

The documentation is currently only in the gh-pages branch, which makes it quite easy for problems to popup if there are API breakages and the documentation isn't updated in sync.

Instead, the doc should probably be put into the master branch (with the repo itself) and deployed into the gh-pages branch via a script.