Adam, TL;DR My point is, if we have to type all of this email around making documentation, then there's a problem. If the barrier to contribute documentation requires 10 different tools, in different places, there is a problem.
This is based on my own personal experience, having been at the Foundation since 2005. I'll leave it at that. Chris On 3/4/13 10:51 AM, "Adam Monsen" <[email protected]> wrote: >On 03/04/2013 07:45 AM, Mattmann, Chris A (388J) wrote: >> My honest observation here is that this is way too much work for >> documentation :) > >I disagree. > >I wrote: >> > 1. migrate all pages from http://github.com/mesos/mesos/wiki >> > into SVN > >Already done. Bam! :) > >> > 2. move anything wiki-like to a new wiki > >This shouldn't be much worse than cutting and pasting... cutting from >Markdown/Textile files in SVN and pasting onto the wiki. Sounds like >there's already a confluence wiki created ( accodrding to >http://incubator.apache.org/projects/mesos.html ). > >But of course, the distinction between canonical documentation vs. wiki >documentation is subjective, so maybe everything will just stay in SVN. >At any rate, this doesn't need to be done right away. > >> > 3. standardize on one markup language > >This is important, IMHO, and can be done automatically using pandoc. >
