Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 7 Apr 2003 01:57:42 -0700 (PDT)
From:      murray@FreeBSD.org
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/50665: Handbook 19.4.5 uses 1st person
Message-ID:  <200304070857.h378vgdH007180@builder.freebsdmall.com>
Resent-Message-ID: <200304070900.h3790Wf5099580@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         50665
>Category:       docs
>Synopsis:       Handbook 19.4.5 uses 1st person
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 07 02:00:31 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Murray Stokely
>Release:        FreeBSD 4.8-RC i386
>Organization:
FreeBSD Mall, Inc.
>Environment:
System: FreeBSD builder.freebsdmall.com 4.8-RC FreeBSD 4.8-RC #21: Sun Mar 23 14:37:00 PST 2003 murray@builder.freebsdmall.com:/usr/obj/usr/src/sys/BUILDER i386

>Description:

The Advanced Networking : Bridging : Performance section includes an
outdated performance antecdote written in the first person.  I was
tempted to just remove the whole thing but there may be some utility
to such a performance testimonial if it can be done in more
professional way.  If this style must be used, then it should at least
start off with "One of the authors" instead of "I" and it should
probably be separated from the main flow of the text in a box or
footnote or something.  Alternatively, the personal testimonial style
can just be dropped in favor or more formal exposition.

>How-To-Repeat:

>Fix:

Sorry no patch yet.
>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200304070857.h378vgdH007180>