Mailing-List: contact cygwin-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin/>
List-Post: <mailto:cygwin AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin AT sources DOT redhat DOT com
Date: Fri, 21 Sep 2001 22:52:13 -0400
From: Christopher Faylor <cgf AT redhat DOT com>
To: cygwin AT cygwin DOT com
Subject: Re: Periodic plea for someone to work on cygwin docs
Message-ID: <20010921225213.B31041@redhat.com>
Reply-To: cygwin AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
References: <20010921143948 DOT A3617 AT redhat DOT com> <3BABF559 DOT 12AE17D8 AT paradise DOT net DOT nz>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3BABF559.12AE17D8@paradise.net.nz>
User-Agent: Mutt/1.3.21i

On Sat, Sep 22, 2001 at 02:20:09PM +1200, Edmund Horner wrote:
>I am looking for a way to make a positive contribution (as opposed to
>asking stupid questions of the list, of which I have been occassionally
>guilty...).  Part of my work responsibility is technical documentation,
>so I have some idea of the kind of technical research that's necessary
>to update these sorts of documents.
>
>Unfortunately I don't know much about either CVS or SGML, though of
>course I could learn.
>
>If the major requirement is simply someone who can write and has the
>time to do so, then I think I can help.  If you think this is a
>possibility, I will re-familiarise myself with the docs and think
>further on it.

I really need someone who can own this.  If you can master CVS and sgml,
it's yours.

CVS, at least is no big deal.  Many people on this list can help you with
this.  There is also some information at the cygwin web page.

Documents on SGML should be available on the web somewhere, I would think.

This is the usual sticking point, however.  People often step forward to
volunteer but are immediately daunted by the technical details.

I'd rather not have to provide active guidance about CVS usage and I can't
provide any guidance at all about sgml.  Having looked at Cygwin's use
of sgml, I can say that it seems pretty intuitive, though.

Maybe I'm in beggars-can't-be-choosers mode but I would really rather
that the documentation efforts not have to involve me overly much.

cgf

--
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/