← Prev in month
← Prev in 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