[m3ntat]

Nice writeup. The whole "your docs site is just on a different branch" has always been weird to me though. I'm not sure what a better way to do it would be but I don't like these two options: switch branches inline or have a separate clone of the repo.

[yesimahuman]

Yea, but theoretically you could set up a new remote repo just for the site, and use a specific branch for it. I think the convenience is well worth the change in process you have to deal with.