Date: Sun, 16 Jun 1996 09:13:18 +0200 (IST) From: Eli Zaretskii To: Leath Muller Cc: djgpp AT delorie DOT com Subject: Re: A more readable faq??? In-Reply-To: <199606132321.JAA00748@gbrmpa.gov.au> Message-Id: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII On Fri, 14 Jun 1996, Leath Muller wrote: > > I think making 2 FAQ lists instead of one will add to confusion and make > > their maintenance more complex. So I want to make the FAQ easily > > searchable so it won't be necessary to read large chunks of text just to > > find an answer to a specific question. > > Not if one is say something like "Starters FAQ", with the readme stating > that if the person is new to djgpp or programming in dos in general, then > they should start with the starters faq...and yes it would be much more work, How will users decide when they cease to be a ``starter'' and should begin reading the full FAQ? How would the FAQ maintainer decide where to put any given question? Right now, the FAQ is organized in a way that keeps beginners' questions near the beginning of the FAQ and in an order that the problems would be seen by someone who installs DJGPP and begins using it. The indices should cover anything that couldn't be found by looking the issue in the table of contents. I don't know of any better way of doing this, but I'm open to suggestions. > Well, this is good, and how I view most of my docs, except for someone who is > new to this sort of thing. For you and myself, this is simple, and anything > we dont know, we just simply look up. For someone who doesnt have a clue > this isnt as abvious. They can use the HTML version. These days everyone knows what HTML is and how it is used. Remember: DJGPP is for developers, not for simple-minded users. Somebody who writes code should know something about how to learn a new system. Yes, DJGPP learning curve *is* somewhat steep for people who lack background in Unix and GNU tools (which is why we are in dire need of tutorials to help these people finding their way), but I don't think it's awful hard to do even now.