From owner-freebsd-doc Fri Dec 14 3:50:19 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id C907F37B405 for ; Fri, 14 Dec 2001 03:50:09 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fBEBo9925367; Fri, 14 Dec 2001 03:50:09 -0800 (PST) (envelope-from gnats) Date: Fri, 14 Dec 2001 03:50:09 -0800 (PST) Message-Id: <200112141150.fBEBo9925367@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Andrew McKay Subject: Re: docs/32818: [PATCH] - Formal Text for /docproj/who.html Reply-To: Andrew McKay Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/32818; it has been noted by GNATS. From: Andrew McKay To: Hiten Pandya Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/32818: [PATCH] - Formal Text for /docproj/who.html Date: Fri, 14 Dec 2001 11:53:06 +0000 (GMT) On Thu, 13 Dec 2001, Hiten Pandya wrote: HP> >Severity: serious HP> >Priority: high How do you justify this classification? Just wondering. To me a serious/high-priority change is one where the documentation may be misleading enough to cause a user to damage their system or render it unbootable. HP> If you like the patch, submit it, dont like it? comment on it. :-) Comments below: HP>

Some of us can commit changes directly to the FreeBSD documentation HP> ! tree. The complete list of people with commit ``privileges'' can be HP> ! found in the Handbook.

I'd be inclined to lose the ``'' around privileges. To my mind they exist around privs to indicate that it is a slang term. HP> !

The general public does not have commit privilges, but they write and HP> ! submit documentation nonetheless. Once the documenation has been HP> ! submitted according to the procedure layed out on the HP> ! Submitting Documentation page, it will HP> ! be noticed by one of the committers and will be reviewed & committed. HP> !

I would phrase this as:

Members of the project who do not have commit privileges can contribute by submitting documentation. Details of how to do this are available on the Submitting Documentation page. Once the submission is received it will be reviewed & committed as appropriate.

Not sure about the need for tags in there but they won't hurt, I guess. Just my comments, as per your request. -- Andrew McKay To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message