Re: [ANNOUNCE] Git wiki

From: Petr Baudis <pasky@suse.cz>
Date: May 3, 2006, 19:30 UTC
Message-ID: <20060503193013.GN27689@pasky.or.cz>
In-Reply-To: <Pine.LNX.4.62.0605031218570.12716@qynat.qvtvafvgr.pbz>

Dear diary, on Wed, May 03, 2006 at 09:21:54PM CEST, I got a letter where David Lang <dlang@digitalinsight.com> said that...

Show 13 quoted lines

> On Wed, 3 May 2006, Jakub Narebski wrote:
> 
> >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).

-- 
				Petr "Pasky" Baudis
Stuff: http://pasky.or.cz/
Right now I am having amnesia and deja-vu at the same time.  I think
I have forgotten this before.