ietf-nntp Reorganising the document

[Russ Allbery]

Clive D W Feather <clive at demon.net> writes:

[...]

> Here is how I suggest things are reorganised. See below the list for
> further notes about the text. Where the section number is preceded by *,
> the text would be changed as described at the end. For all other
> sections, the text remains unchanged apart from the renumbering.

I support Clive's change of ordering; I think it flows better.

> The text at the start of the old 9.1 ("Article Retrieval") describes the
> organisation of articles on the server. It isn't specifically to do with
> the GROUP/LAST/NEXT commands; it applies equally to other commands like
> NEWNEWS. Therefore I would do one of the following:

> (A) Delete the old 9.1 heading, so that the text becomes part of the
> introduction to section 9.

> (B) Take the view that this is "basic concepts" material. In that case,
> move the first sentence to the end of the introduction of section 9 and
> move the rest to a new section "4.2 Article organisation and indexing".

I think (A) is the best option.  Keeping the description of article
numbers close to the commands that use them seems wise.

> The only other question is whether section 8 (LIST EXTENSIONS) fits
> better as part of this new 12 (it would be 12.2, with the remaining
> sections moved down one). To do this would require more extensive
> renumbering.

I think it's okay where it is.  It's important enough (particularly since
it's new) that I don't mind introducing it early.

-- 
Russ Allbery (rra at stanford.edu)             <http://www.eyrie.org/~eagle/>