moving to a git-backed wiki
- From
Jeff King <peff@peff.net>
- Date
- Feb 1, 2011, 20:11 UTC
- Message-ID
- <20110201201144.GA16003@sigill.intra.peff.net>
- In-Reply-To
- <AANLkTimHCp_JKUw1keJoA4zD_q7Sci+rOwPeAs_T=7xH@mail.gmail.com>
On Tue, Feb 01, 2011 at 10:34:24AM -0800, Scott Chacon wrote:
Show 12 quoted lines
> > GitHub's wiki gets this right. I'm not saying we should host our wiki > > there (well, it _would_ make setting it up pretty damn easy). But their > > wiki system (gollum) is open-source, albeit in ruby. And surely there > > are other git-backed alternatives (it's been a while since I've looked). > > If you want to use the wiki on the git/git repo on GitHub that is > being mirrored from the canonical repository, I've added Junio and > peff to the account. If you want to use that wiki, anyone with a > github account can edit wiki pages on the site or clone and edit it > locally and push changes up. You can also turn off site edits so > people have to send Junio a patch instead. It's up to you guys, but > the access is there now if you want.
Out of curiosity, I scraped the kernel wiki and put it into gollum. The results are here, if people want to see what it looks like:
https://github.com/peff/foo/wiki
It's extremely quick and dirty, which is why I didn't put it in the actual git/git/wiki spot you made. Some of the formatting is off (note that I didn't do any conversion; it understands mediawiki natively), and some of the content is probably missing (my scraper was extremely naive). For a real import I would try to get the actual wiki db from kernel.org and import the entire history.
I dunno what the next step would be. I would really prefer a git-backed wiki, but moving to something like this is a pretty big step in workflow for people who use the current wiki. I would be curious to hear general opinions (on the idea of moving, assuming we did a conversion that actually looked good). I'll change the subject and see if we get any comments.
-Peff