IETF-SSH archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

Re: filexfer: rationale style text in draft...





On Monday, August 22, 2005 10:08:39 PM -0600 Joseph Galbraith <galb-list%vandyke.com@localhost> wrote:

I've a question for you draft-writing pros...

Strewn throughout the filexfer draft are comments like the
following examples:

 > However, to ease the burden of implementation on servers that
 > use a single, simple, seperator sequence...

or

 > Note that the name "supported2" is used here to avoid conflict
 > with the slightly different "supported" extension that was
 > previously used.

In addition, there is the 'change-log' section.

Am I correct in thinking that this kinds of 'rationale'
or 'history' type comments are not appropriate, and
should be removed?

The changelog should generally be removed in the RFC-editor process.
Rationale does not in general seem inappropriate to me, especially when the reason for a decision is non-obvious.



Home | Main Index | Thread Index | Old Index