Re: [ANNOUNCE] Git wiki

On Wed, 3 May 2006, Petr Baudis wrote:

Dear diary, on Wed, May 03, 2006 at 09:21:54PM CEST, I got a letter
where David Lang [off-list ref] said that...

quoted

On Wed, 3 May 2006, Jakub Narebski wrote:

quoted

As to content, we could I think use material found at Wikipedia Git page,
and on External Links in Wikipedia Git_(software) article, not repeating of
course what is in official Git Documentation/

please go ahead and put a lot of the info that is in the GIT 
Documentation/ on the wiki. it's far easier to go to one site and browse 
around to find things then to run into issues where you have to go 
somewhere else (with different tools) to find the info.

even if you just put all the documentation files there, as-is (as text 
files even, no hyperlinks in them) they should still be there.

Then who will keep it in sync (BOTH ways)? That would be quite a lot of
work, I think.

That said, having the documentation in a wiki is not a bad idea per se,
but you need to keep things consistent and converging. And I believe
(and hope) that killing Documentation/ directory is no option - I hate
it when documentation of software I installed just tells me "look at
this URI" (which documents a different version anyway, and it's all very
useful when I'm sitting in a train with my notebook).

Clearly the solution is a wiki with a git backend and asciidoc for the 
formatting language. Then the wiki just has to pull from kernel.org 
occasionally, and Junio can pull from the wiki's repository when there are 
good changes there.

I'm actually only somewhat joking; I wrote a Python CGI for this at one 
point, and got as far as having it basically work, but then I couldn't 
come up with a way to safely use asciidoc to format an attacker's file.

	-Daniel
*This .sig left intentionally blank*