[mdehaan]

I find the gh_pages branch confusing too -- the idea that a branch doesn't contain something related to the other branches feels weird.

What I've found is it's easier to create a free organization, and that way you can get a organization.github.com project created and host the pages there.... this is easier than juggling the spare branch. Obviously smaller starter projects should not do this, but you could use username.github.com/yourproject name and not keep the documentation on the branch just as easily.

Presto, no gh_pages branch, but all of the advantages of hosting web content.