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: Re: Feedback: TAB-555 Bad sub-sectioning

Patrick Durusau <patrick@durusau.net> writes:
> Hash: SHA1
> Rusty,
> I did a bad job explaining that one. My bad.

Hi Patrick,

        Actually, I should have read your following section on
hanging paragraphs: together they make a great deal of sense.

I'm still going to disagree, though :)

> So at first blush I would say:
> 2.2 Features
> 2.2.1 Feature Bits Interface
> 2.2.2 Legacy Interface: A Note on transitions from earlier drafts

I cringe when I'm faced with reading documents structured like this.
There's a tension between the flow of the document which makes it
readable as a whole, and its use as a reference which makes it readable
in parts.

I want both.  The section 2.2 text should contain welcoming text which
introduces the whole section, and the normative parts (aka reference)
should be called out into sections.

I'm restructuring the document to tease out the normative statements;
let's see how that goes then revisit this.


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