From owner-freebsd-doc  Wed May  3 21:51:24 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from berlin.atlantic.net (berlin.atlantic.net [209.208.0.20])
	by hub.freebsd.org (Postfix) with ESMTP
	id 4FBE237BF99; Wed,  3 May 2000 21:51:18 -0700 (PDT)
	(envelope-from bobj@atlantic.net)
Received: from mail.atlantic.net (mail.atlantic.net [209.208.0.71])
	by berlin.atlantic.net (8.9.3/8.9.3) with ESMTP id AAA08016;
	Thu, 4 May 2000 00:55:16 -0400
Received: from atlantic.net (ocalflifanb-as-1-r1-ip-231.atlantic.net [209.208.28.231])
	by mail.atlantic.net (8.9.3/8.9.3) with ESMTP id AAA10411;
	Thu, 4 May 2000 00:51:01 -0400
Message-ID: <391100E7.966B7512@atlantic.net>
Date: Thu, 04 May 2000 00:47:36 -0400
From: Bob Johnson <bobj@atlantic.net>
X-Mailer: Mozilla 4.72 [en] (X11; U; FreeBSD 4.0-RELEASE i386)
X-Accept-Language: en
MIME-Version: 1.0
To: Nik Clayton <nik@FreeBSD.ORG>
Cc: Sheldon Hearn <sheldonh@uunet.co.za>, doc@FreeBSD.ORG
Subject: Re: SSH not in Handbook table of contents
References: <20000429171658.I706@kilt.nothing-going-on.org> <516.957349157@axl.ops.uunet.co.za> <20000504013826.A16269@catkin.nothing-going-on.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Nik Clayton wrote:
> 
> On Wed, May 03, 2000 at 12:19:17PM +0200, Sheldon Hearn wrote:
> > On Sat, 29 Apr 2000 17:16:58 +0100, Nik Clayton wrote:
> >
> > > Correct on both counts, I think.  Could you file a PR about this with
> > > the new "wish list" category?  Cheers.
> >
> > Woah.  The "wish" category isn't ready for prime time yet.  It's
> > intended for PR's that have been submitted with no solutions for the
> > problems they report.
> 
> It's not?  Isn't "We need to write a section about ssh in the handbook"
> a wish list item?

I don't know about the "wish" category, but:

Perhaps, at least as a short term solution, changing the section title 
for Section 8.3 ("Securing FreeBSD") to "Securing FreeBSD: SSH and 
Other Tools" or something like that would do the trick.  That way, 
someone looking through the TOC for information on SSH would be 
able to find it.

I went ahead and submitted the above suggestion (the title change 
for section 8.3) as a PR, although not in the "wish" class.  If 
you also want me to suggest a re-write to split SSH out into its 
own section, I'll be glad to submit that as a sort of beta test 
of the "wish" class...

By the way, I'm traveling and don't have the complete text of 
my original posting with me.  I hope my PR adequately addressed 
my original complaint ;)


I didn't know about the "wish" category before, but now that I look 
at the PR page (at 900 bps :( )  I see that it is not a "category",
but instead is a "class".  I can't report it simultaneously as a 
"doc-bug" and a "wish", which how I would categorize it. It seems 
to me (after admittedly brief thought) that "wish" ought to be a 
category rather than a class.


-- Bob


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message