← Prev in month ← Prev in thread

Feedback: TAB-555 Bad sub-sectioning

From
Rusty Russell <>
Date
2014-02-16T23:37:20+00:00
ID
Thread
Feedback: TAB-555 Bad sub-sectioning
Hi Partick,

I disagree with this one:

	In order to have a subsection, it is necessary to have at least
	two subsections. Thus: 1. Title 1.1 sub-title 1.2 sub-title is
	correct, but, 1. Title 1.1 sub-title 2. Title is incorrect. Just
	listing the incorrect sub-sections: 2.2.1, 2.4.3.1, 2.4.4.1,
	3.1.1, 4.1.1.1, 4.3.2.1.1, 4.3.2.2.1, 5.1.3.1, 5.1.4.1,
	5.1.6.2.1, 5.1.6.3.1, 5.2.3.2.1, 5.2.4.1, 5.2.5.1, 5.3.4.1,
	5.3.6.1, 5.5.4.1, 5.5.6.1.1, 5.6.4.1, 5.6.6.1.1, 5.6.6.2.1,
	5.6.6.3.1, and 6.1

A sole subsection without any contents in the section itself is almost
certainly a mistake, but the general form of:

 SECTION

 words words word...
  ...
 lots of words.

    SUBSECTION

    more more words

Seems reasonable.  In fact, it's hard for me to see how to fix "2.4.4.1
Indirect Descriptors" without creating a fake subsection called "2.4.4.1
Normal Descriptors".

And if we were to fix these, we would no longer have the bright line
which separates Legacy Interface sections.  This was initially going to
be an entirely separate document, but consensus was that this compromise
of separate sections was clearer.

Cheers,
Rusty.
← Prev in month ← Prev in thread