Re: Why is GNUstep less successful than GTK and Qt??

[Lars Sonchocky-Helldorf]

On 16.06.2003 18:38:29 "Chris B. Vetter" wrote:
>On Sat, 14 Jun 2003 10:51:44 -0000
>MJ Ray <markj+0111@cloaked.freeserve.co.uk> wrote:
>> Chris B. Vetter <chrisv@web4inc.com> wrote:
>> > - lack of (clear/clean) documentation
>> >   eg. where can the docu to XY be found, why is docu for YZ missing
>> I want to work on this by reshaping GNUstep.org a bit.  Please email
>> me suggestions/encouragement/flames and I'll work on it faster.
>
>That's a start but wasn't what I had in mind.
>
>For example in my case, I usually only have time (and the will) to
>do some private programming over the weekend, at home where I
>(voluntarily) do not have Internet access.
>So online documentation is pretty much useless from my point of view.
>
>What's missing is documentation that can be found on your local machine.
>IMHO, autogsdoc does a very good job for documenting frameworks,
>libraries and such.
>
>However, looking at the pages for NSSomeThing is pretty frustrating
>since about 90% of all methods sport a "Description forthcoming".
>
>That's what I was talking about.

I think it would be the best effort to maintain the documentation in the 
sourcefiles and create the online docs automatically from it, maybe during 
the process that creates the daily snapshots. So everything will be in 
sync and up to date - no double work will be needed.

greetings, Lars