Building a Docs Site with Jekyll + GitHub Pages

Yea, unfortunately this isn't the best setup for non-technical users, but I think it can still be decently done through the github editing features they recently added. I probably won't use this for some of our more content-heavy sites, but I've grown to appreciate hosting static content on Github pages.

Well, the CMS is the classical way to do it. Using Jekyll and Github is a more recent and innovative way to do stuff, much simpler to use for developers and cheaper because it's free hosting that can scale pretty well.

Of course if you want marketing people to edit stuff asking them is use Git is going to be painful.

This is for project docs and such, not for marketing people but for the people working on the project.

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.

Not the same thing (since this isn't an API), but I like what balanced does: https://github.com/balanced/balanced-api

I'm using a Jenkins build to run Sphinx on my Python projects. Having to move the changes into the gh-pages branch is a bit awkward, but it's working pretty well.