Date: Sun, 22 Dec 2002 13:49:31 -0500
Message-Id: <200212221849.gBMInVv30334@envy.delorie.com>
X-Authentication-Warning: envy.delorie.com: dj set sender to dj AT delorie DOT com using -f
From: DJ Delorie <dj AT delorie DOT com>
To: djgpp AT delorie DOT com
In-reply-to: <au4lel$an5$1@news.online.de> (lars.o.hansen@gmx.de)
Subject: Re: dynamic gotos possible with djgpp?
References: <au1u53$vdj$1 AT news DOT online DOT de> <Xns92EB68088B9B7asu1cornelledu AT 132 DOT 236 DOT 56 DOT 8> <au23ou$3fg$1 AT news DOT online DOT de> <Xns92EB7B297691Casu1cornelledu AT 132 DOT 236 DOT 56 DOT 8> <au2fg4$bmj$1 AT news DOT online DOT de> <3E04FDB0 DOT 1E820A90 AT phekda DOT freeserve DOT co DOT uk> <au4lel$an5$1 AT news DOT online DOT de>
Reply-To: djgpp AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk


> FAQ: too much in one file:

Well, there are a *lot* of frequently asked questions ;-)

> web browsers scrollbar is tiny; difficult to move up and down;

That's not something we can fix.  The TOC for the faq is only four
"pages" long on my browser; I think that's about ideal.

> each section in one file, the ToC (1-25) divided into sections too (1-5,6-8,...), so there are just
> ~5 headings on the first page + FAQ List text.

Or a TOC with only the main headings (1, 2, 3) not the subheadings
(1.1, 1.2).  But I think that would make it harder to find things.

> The FAQ's content is actually quite good, but the name FAQ doesn't
> suggest all the content which can be found in the FAQ, so it should
> perhaps renamed to sth. like "djgpp Usage reference" (not thought
> about that name)?

We've talked about migrating some of the larger topics over to the
User's Guide.  We could use lots of help here.

> Readme: too much unrelevant information at the beginning (one has
> already downloaded and "installed" !);

The README is in the root of the ftp site.  That's its intended
purpose, for people who are about to download it.  If you use the zip
picker, it's instructions pretty much replace the readme.

> Web: th eonly really helpful resource for beginners on delorie.com is the FAQ (but that comes with
> zips too):

> User's Guide: link not working;

http://www.delorie.com/djgpp/doc/ug/

> how-to repository: specialised topics, irrelevanmt for beginners
> (mainly...),

That's its purpose - specialized information with great detail.

> C library refernce: good! ;

Whew.  Considering it's 650 printed pages, it better be good.

> djgpp documentation: most is unrelevant for beginners,

Which ones are you talking about here?

> project overview shortcomings: too much on 1 html page!;

That's a copy of a paper Eli once gave.  It wasn't intended to be
online when it was written.

> GNU manuals: coming from Ms world, one has no idea what gnu is and
> what djgpp has got to do with it, the link seems to link to a long
> list of words, an index, but one can't be bothered to even start
> reading;

True.  And I haven't had a chance to update them recently either.

> overall problem: too much information, the docs don't get to the
> point fast enough;

There is a lot of information, yes.  That makes it harder to organize.

> So the whole structure should be clear from the beginning and when
> one follows a link, one should know in which part of the doc
> structure one is, that means, what the theme of the section is one
> has landed in.

If you think you can do better, I'm willing to give you the chance.