X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-0.0 required=5.0	tests=AWL,BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,KHOP_RCVD_TRUST,KHOP_THREADED,RCVD_IN_DNSWL_LOW,RCVD_IN_HOSTKARMA_YE
X-Spam-Check-By: sourceware.org
MIME-Version: 1.0
In-Reply-To: <20121202212829.GA26206@ednor.casa.cgf.cx>
References: <CAARFOs-gsLkrPcBBYyJyZcfOwzci8fVLZbUCWXWdAhvgQ_8++A AT mail DOT gmail DOT com>	<20121202174518 DOT GA9538 AT ednor DOT casa DOT cgf DOT cx>	<20121202194313 DOT GT67410 AT justpickone DOT org>	<20121202212829 DOT GA26206 AT ednor DOT casa DOT cgf DOT cx>
Date: Mon, 3 Dec 2012 10:23:14 -0500
Message-ID: <CAARFOs-hMQ3p-Ww+aN-4us6FU76JR4itvPeQrO7g8cHMuBo3fA@mail.gmail.com>
Subject: Re: Where can I find the official cygwin openssh documentation?
From: Mike Richardson <javaguy940 AT gmail DOT com>
To: cygwin AT cygwin DOT com
Content-Type: text/plain; charset=ISO-8859-1
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Precedence: bulk
List-Id: <cygwin.cygwin.com>
List-Unsubscribe: <mailto:cygwin-unsubscribe-archive-cygwin=delorie DOT com AT cygwin DOT com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/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

Christopher, thanks very much for pointing me in the right direction
for the official documentation -- it was very helpful.

I see why these step-by-step openssh+cygwin guides appearing on the
Internet are annoying to you and other cygwin experts -- not only
should they be unnecessary, but they also contain false and misleading
information. When they fail, people then come and post on this mailing
list annoying the experts, or give up, or have to spend a lot longer
trying to figure out the problem.

Thus I make this suggestion: can we put this openssh+cygwin
documentation up on the cygwin web site?  When people are looking for
documentation, it is generally the case they use a web search engine.
Because this documentation doesn't appear on the cygwin web site,
Google returns these step-by-step guides as the top hits.   Thus it's
the first and sometimes the only documentation people use on the
subject.

On Sun, Dec 2, 2012 at 4:28 PM, Christopher Faylor wrote:
>
> And, FYI, most of those step-by-step guides that I am aware of were just
> wrong.  The whole point of a setup script is to set-up-ssh.  If
> something isn't working then it's a bug to be reported and worked on.
> You can see many cases of Corinna changing the script when people report
> problems.  The step-by-step guides should not be necessary.
>
> And, before anyone has an indignant reply to this, I'll say it again: If
> the setup scripts didn't work work for you then they can be fixed.  A
> step-by-step guide is a band-aid.
>

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple