From nobody@FreeBSD.org Thu Dec 13 16:21:12 2001 Return-Path: Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 21F1B37B405 for ; Thu, 13 Dec 2001 16:21:12 -0800 (PST) Received: (from nobody@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fBE0LCH00161; Thu, 13 Dec 2001 16:21:12 -0800 (PST) (envelope-from nobody) Message-Id: <200112140021.fBE0LCH00161@freefall.freebsd.org> Date: Thu, 13 Dec 2001 16:21:12 -0800 (PST) From: Hiten Pandya To: freebsd-gnats-submit@FreeBSD.org Subject: [PATCH] - Formal Text for /docproj/who.html X-Send-Pr-Version: www-1.0 >Number: 32818 >Category: docs >Synopsis: [PATCH] - Formal Text for /docproj/who.html >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Dec 13 16:30:01 PST 2001 >Closed-Date: Fri Jan 11 16:51:06 PST 2002 >Last-Modified: Fri Jan 11 16:52:03 PST 2002 >Originator: Hiten Pandya >Release: 5.0-CURRENT >Organization: >Environment: FreeBSD hpdi.ath.cx 5.0-CURRENT FreeBSD 5.0-CURRENT #1: Wed Dec 12 00:34:45 GMT 2001 hitenp@hpdi.ath.cx:/usr/obj/data/dev/src/sys/CURRENT5 i386 >Description: the patch i have attached will replace some of the informal, and sloppy (sorry bout my bluntness) bits of http://www.FreeBSD.org/docproj/who.html with more formal text and better stucture. The reason for this is very obvious; translaters will find it easy to translate. If you like the patch, submit it, dont like it? comment on it. :-) >How-To-Repeat: n/a / visit http://www.FreeBSD.org/docproj/who.html >Fix: *** who.sgml.old Thu Dec 13 23:34:07 2001 --- who.sgml Thu Dec 13 23:47:14 2001 *************** *** 13,25 **** FreeBSD-doc@FreeBSD.ORG.

Some of us can commit changes directly to the FreeBSD documentation ! tree. The complete list of people with commit ``privs'' is in the ! Handbook.

!

Others do not have commit privs, but they write and submit documentation nonetheless. One of the ! committers will then include it in the documentation set.

If you want to help out with the documentation project (and I fervently hope you do) all you have to do is subscribe to the mailing list and --- 13,27 ---- FreeBSD-doc@FreeBSD.ORG.

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

!

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

If you want to help out with the documentation project (and I fervently hope you do) all you have to do is subscribe to the mailing list and *************** *** 27,32 **** project.

FreeBSD Documentation Project Home ! &footer --- 29,34 ---- project.

FreeBSD Documentation Project Home ! &footer; >Release-Note: >Audit-Trail: 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 From: Ceri 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 18:55:40 +0000 > If you like the patch, submit it, dont like it? comment on it. :-) Comments below, as requested. > ! tree. The complete list of people with commit ``privileges'' can be As someone else pointed out, priviliges isn't slang or an abbreviation. Best to lose the quotes altogether I feel. > !

The general public does not have commit privilges, but they write and > ! submit documentation nonetheless. Once the documenation has been ``The general public'' is either singular, or it's plural. Not both. You have also spelt documentation incorrectly. Time to install ispell ? ;) > ! submitted according to the procedure layed out on the s/layed/laid/ > ! be noticed by one of the committers and will be reviewed & committed. What's wrong with ``and'' instead of ``&'' ? Ceri -- keep a mild groove on State-Changed-From-To: open->closed State-Changed-By: bmah State-Changed-When: Fri Jan 11 16:51:06 PST 2002 State-Changed-Why: Fixed the issues with the patch, plus fixed a bunch of other problems on this page. The changes should show up within the next 24 hours. Thanks for the submission! http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32818 >Unformatted: