Documentation Maintainability with WordPress. Jekyll?

[justingeeslin]

At first I thought it would be a good idea to make a beautiful documentation site consolidating all the docs for the various sources around the web in a Wordpress site and putting a static version of the site in the docs folder to be served out by GitHub pages.

But from a community maintainability perspective, this might not be viable. How will others edit these HTML files, and once they do how would I pull back in their changes in to the Wordpress site from which I'm generating the docs?

I'm not familiar with what GitHub Pages recommends, Jekyll. I may give it a shot in the name of community maintainability. The idea is that the docs can stay markdown and GH Pages will generate the HTML version to be consumed by the browser.

[justingeeslin]

Make progress creating a more maintainable documentation site using GitHub's Pages feature / Jekyll. PR coming soon.

[justingeeslin]

#26 Fixes this issue; now we can all collaborate on plain-text, markdown files for documentation that is kept in-branch.