On Tue, Jul 28, 2015 at 11:30:01AM +0530, kunaal jain wrote: > Hi, I just wanted to mail community first and get the discussion started, > but I should have written details first. > > The main aim behind this project is to facilitate contributors, so the > site generator should be such that, it doesn't complicate the workflow. > Another constraint is that the site generator should require minimal human > effort, as we plan to build the site continuously through CI, so the new > content should automatically be indexed, added to navigation panels, > content directory etc. > > Coming to existing site generators, we looked at Jekyll, Hugo and Mkdocs. > > Hugo - very flexible, great tool but complicated. User needs hugo > installed to contribute. Docker uses this, switching from mkdocs. > > Mkdocs - Not very flexible, but very friendly. User needs to create doc in > mardown, add the link in another file and done! > > Jekyll -- very blog specific, which we don't require. > > What do you think about it? There is also Nikola for static content generator, relies on the rest syntax and can be themed. Pierre