delorie.com/archives/browse.cgi   search  
Mail Archives: cygwin/2003/03/24/17:37:02

Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
From: "Hannu E K Nevalainen (garbage mail)" <garbage_collector AT telia DOT com>
To: <cygwin AT cygwin DOT com>
Subject: RE: Added setup.exe to User's Guide
Date: Mon, 24 Mar 2003 23:35:35 +0100
Message-ID: <NGBBLLIAMFLGJEOAJCCECECCCNAA.garbage_collector@telia.com>
MIME-Version: 1.0
X-Priority: 3 (Normal)
X-MSMail-Priority: Normal
Importance: Normal
In-Reply-To: <Pine.GSO.4.44.0303241240130.561-100000@slinky.cs.nyu.edu>
X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2615.200

> From: Igor Pechtchanski [mailto:pechtcha AT cs DOT nyu DOT edu]
--8<--
> IIRC, the only gotcha about using setup's cache on a CD-R was to not put
> it in the root of the CD-R (because of the way Windows omits the "\" from
> the root path, and that confuses setup).  Placing the cache in a
> subdirectory, say, "G:\cygwin" works perfectly fine.

Ok. I didn't catch that one, obviously.


My general point in this thread has been:
 Documentation should include simple pointers and just enough
information on use. Just so that an intelligent beginner can
read the text and find the information he needs.


Background:
 A few years back, when I was a beginner, I found it REAL HARD to
catch the hook - simply because the documentation was so
"beginner-unfriendly" (BUF ;-). I occassionally still have a
hard time finding the correct place in the docs.
 IMHO the docs doesn't need much of a change, just a few words here
and a reference or a pointer there. And this is all it is about...

 Without those *tiny* details, you're out in the cold as beginner.
If you're stubborn enough (I have been told I'm VERY stubborn) you'll
get a hang on it... If you're not... Well...

 Getting more users to the free software world is "A Good Thing"
i.e. a benefit for us all. 
IMHO creating *too* terse docs is counterproductive in this sense.

/Hannu E K Nevalainen, Mariefred, Sweden 

--END OF MESSAGE-- 

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Bug reporting:         http://cygwin.com/bugs.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/

- Raw text -


  webmaster     delorie software   privacy  
  Copyright © 2019   by DJ Delorie     Updated Jul 2019