I was looking for a way to embed docs in my open source project in a way that they're versioned and browsable from Github. And of course publish them. The solu

I was looking for a way to embed docs in my open source project in a way that they're versioned and browsable from Github. And of course publish them. The solution I used was Jekyll + Github Pages. Not particularly surprising but there were a couple minor caveats, so I thought to detail the experience. If anyone from Github is reading, it'd be nice to have more themes for docs. I think embedding docs into the project is nice, but there's some clear resistance given that there's no easy to use theme.