On 02/27/2013 09:37 AM, Benjamin Hindman wrote: > IMHO having your documentation editable and living in a repository is > much more manageable than via an external wiki.
Totally. I'm with you. > If the project wasn't mirrored at github.com/apache/mesos > <http://github.com/apache/mesos> then I'd suggest changing the format of > the documentation, but since we should just be able to point people to > the documentation nicely rendered in github, it seems like a > straightforward first step. Ah, right, the mirror! Good call. So, let's do this. Here's what I'm thinking: 1. migrate all pages from http://github.com/mesos/mesos/wiki into SVN 2. move anything wiki-like to a new wiki 3. standardize on one markup language For #1, it would be nice to preserve history (who did what and when) for posterity. This is a little tricky with SVN though, see below. I suggest doing #1 and #2 in two different steps, also for posterity. For #3, Either seems fine. If you don't have a preference I'll default to Markdown since I've used it more. I asked Andy K. to reassign MESOS-69 to me... it seems close enough. I made some changes and went to post them to Review Board, but I ran into a few difficulties. First off, I didn't see a "mesos" repository, just a "mesos-git" repository. Is that the one I should choose? Because I want to preserve history, my "diff" is actually every commit performed on http://github.com/mesos/mesos/wiki (that wiki is backed by a standard git repository). That's 708 commits. These apply cleanly to trunk. The pages were in the top-level dir of the Mesos source tree, so I did one additional patch to move all the wiki pages into the doc/ subdir. Here are the patches. They can be applied to trunk (git) using `git am *.patch`. They can be applied to trunk (svn) using `for i in *.patch; do patch -p1 < $i; done`. http://adammonsen.com/tmp/migrate-mesos-doc-git-patches.tgz (SHA-1: f0b2e9c655237f0dd9cf83daaec8f62771bad892 ) If that just won't work, here's a single patch created with `svn diff` (after doing the for loop, above). Note that if you use this one you'll have to manually add the two images from the old github wiki. http://adammonsen.com/tmp/migrate-mesos-doc-svn.patch.gz (SHA-1: a5752c2b941e79d773b2e931cfcd73ac85fa7450 ) I'm in the IRC channel, so if it would be easier to chat this up in there, stop on in. If I'm away I'll get my messages when I return. Let's talk about #2 and #3 after we finish #1.
signature.asc
Description: OpenPGP digital signature
