OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

virtio-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: 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.



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]