I think one of the confusing parts of linking to/rendering Mesos documentation as markdown files on github.com is that dev is happening on Apache JIRA and the git repo.. not GitHub.
Planning to link to documentation somewhere else in the long-term sounds good. On Thu, Jun 13, 2013 at 12:40 PM, Andy Konwinski <[email protected]>wrote: > In the slightly longer term, the next step is to set up a post-commit hook > that runs a markdown compiler somewhere and pushes the recompiled docs to > the website, perhaps http://incubator.apache.org/mesos/docs/{trunk or > master} and we can also have a version of the docs associated with each > release at http://incubator.apache.org/mesos/docs/<VERSION> and > docs/latest-release can point to the most recent release. > Great idea! And also, +1 for using the repo, although I do agree with Ben M that this does raise the barrier to entry for someone who wants to contribute to the documentation. Perhaps the simplest solution for that is to improve and update the documentation for how to contribute. Dave
