RE: [dhcwg] Re: Several reminders

"Bernie Volz (EUD)" <Bernie.Volz@am1.ericsson.se> Mon, 27 August 2001 22:13 UTC

Received: from optimus.ietf.org (ietf.org [132.151.1.19] (may be forged)) by ietf.org (8.9.1a/8.9.1a) with ESMTP id SAA02414; Mon, 27 Aug 2001 18:13:52 -0400 (EDT)
Received: from optimus.ietf.org (localhost [127.0.0.1]) by optimus.ietf.org (8.9.1a/8.9.1) with ESMTP id SAA07731; Mon, 27 Aug 2001 18:08:05 -0400 (EDT)
Received: from ietf.org (odin [132.151.1.176]) by optimus.ietf.org (8.9.1a/8.9.1) with ESMTP id SAA07700 for <dhcwg@ns.ietf.org>; Mon, 27 Aug 2001 18:08:02 -0400 (EDT)
Received: from imr1.ericy.com (imr1.ericy.com [208.237.135.240]) by ietf.org (8.9.1a/8.9.1a) with ESMTP id SAA02101 for <dhcwg@ietf.org>; Mon, 27 Aug 2001 18:06:39 -0400 (EDT)
Received: from mr6.exu.ericsson.se (mr6u3.ericy.com [208.237.135.123]) by imr1.ericy.com (8.11.3/8.11.3) with ESMTP id f7RM80p19097 for <dhcwg@ietf.org>; Mon, 27 Aug 2001 17:08:00 -0500 (CDT)
Received: from eamrcnt747.exu.ericsson.se (eamrcnt747.exu.ericsson.se [138.85.133.37]) by mr6.exu.ericsson.se (8.11.3/8.11.3) with SMTP id f7RM80T16032 for <dhcwg@ietf.org>; Mon, 27 Aug 2001 17:08:00 -0500 (CDT)
Received: FROM eamrcnt760.exu.ericsson.se BY eamrcnt747.exu.ericsson.se ; Mon Aug 27 17:07:59 2001 -0500
Received: by eamrcnt760.exu.ericsson.se with Internet Mail Service (5.5.2653.19) id <P4MP5VLM>; Mon, 27 Aug 2001 17:07:58 -0500
Message-ID: <66F66129A77AD411B76200508B65AC697B34A7@eambunt705.ena-east.ericsson.se>
From: "Bernie Volz (EUD)" <Bernie.Volz@am1.ericsson.se>
To: "'Stuart Cheshire'" <cheshire@apple.com>, Ted Lemon <mellon@nominum.com>, DHCP discussion list <dhcwg@ietf.org>
Subject: RE: [dhcwg] Re: Several reminders
Date: Mon, 27 Aug 2001 17:07:57 -0500
MIME-Version: 1.0
X-Mailer: Internet Mail Service (5.5.2653.19)
Content-Type: multipart/alternative; boundary="----_=_NextPart_001_01C12F44.BAA3C0A0"
Sender: dhcwg-admin@ietf.org
Errors-To: dhcwg-admin@ietf.org
X-Mailman-Version: 1.0
Precedence: bulk
List-Id: <dhcwg.ietf.org>
X-BeenThere: dhcwg@ietf.org

Stuart, I think Ted misunderstood what you requested ... I did too until I
looked at your examples.

Just to be clear, Ted he wasn't asking you to describe what the document said.
He was just saying that you should put in full sentences.

Look at the examples Stuart gave of the changes. I do think they are good changes
because, as Stuart pointed out, you do not need to look up the reference to
understand the sentence. The different is sutble but significant. A very
simple example is rather than to use " ... the Transmission Control Protocol [RFC 793]"
instead of " ... [5]" where [5] is a reference to RFC 793.

I think this change is minor enough that it should be allowable during the final
editing process (perhaps the RFC-Editor would do it anyway)?

- Bernie

-----Original Message-----
From: Stuart Cheshire [mailto:cheshire@apple.com]
Sent: Monday, August 27, 2001 4:56 PM
To: Ted Lemon; DHCP discussion list
Subject: [dhcwg] Re: Several reminders


>Actually, this is not true, and is a dangerous idea.   If I define the
>format of something that's authoritatively defined elsewhere in my own
>draft, and I make a mistake in transcribing or paraphrasing the
>authoritative source, this is likely to create interoperability
>problems when someone doesn't refer to the source.   So I _must_ refer
>to the authoritative source, and _must not_ paraphrase it.

Ted,

I'm not understanding your point.

I didn't say that you shouldn't have references. What I said was that 
writing a number in little square brackets doesn't exempt the writer from 
the normal rules of English grammar. Footnotes and endnotes are not the 
English language equivalent of "#include". If the text is necessary for 
the basic understanding of the sentence, then it should be in the 
sentence. Footnotes and endnotes can provide additional clarification, 
but the sentence should still be grammatically correct if you ignore them.

This seems to be a modern trend in writing, particularly in documents 
like RFCs which not academic research papers, but are written somewhat in 
that style. If you look at research publications from fifty years ago, no 
one would ever have thought of using a sprinking of footnote and endnote 
references as a substitute for a grammatically correct sentence.

Stuart Cheshire <cheshire@apple.com>
 * Wizard Without Portfolio, Apple Computer
 * Chairman, IETF ZEROCONF
 * www.stuartcheshire.org



_______________________________________________
dhcwg mailing list
dhcwg@ietf.org
http://www1.ietf.org/mailman/listinfo/dhcwg