Re: [virtio-comment] Re: Feedback: TAB-555 Bad sub-sectioning

[Patrick Durusau <patrick@durusau.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Rusty,

+1! to waiting until the changes are done to revisit this comment.

I "cringe" to say so but if called upon to choose, I would opt for
readability so long as I didn't stray too often from normal structure
(may my favorite English teacher forgive me). ;-)

Hope you are having a great week!

Patrick

On 02/17/2014 08:08 PM, Rusty Russell wrote:
> 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.
> 
> Thanks, Rusty.
> 
> 
> This publicly archived list offers a means to provide input to the
> 
> OASIS Virtual I/O Device (VIRTIO) TC.
> 
> 
> 
> In order to verify user consent to the Feedback License terms and
> 
> to minimize spam in the list archive, subscription is required
> 
> before posting.
> 
> 
> 
> Subscribe: virtio-comment-subscribe@lists.oasis-open.org
> 
> Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
> 
> List help: virtio-comment-help@lists.oasis-open.org
> 
> List archive:
> https://lists.oasis-open.org/archives/virtio-comment/
> 
> Feedback License:
> https://www.oasis-open.org/who/ipr/feedback_license.pdf
> 
> List Guidelines:
> https://www.oasis-open.org/policies-guidelines/mailing-lists
> 
> Committee: https://www.oasis-open.org/committees/virtio/
> 
> Join OASIS: https://www.oasis-open.org/join/
> 

- -- 
Patrick Durusau
patrick@durusau.net
Technical Advisory Board, OASIS (TAB)
Co-Chair, OpenDocument Format TC (OASIS)
Editor, OpenDocument Format TC, Project Editor ISO/IEC 26300
Former Chair, V1 - US TAG to JTC 1/SC 34
Convener, JTC 1/SC 34/WG 3 (Topic Maps)
Co-Editor, ISO 13250-5 (Topic Maps)

Another Word For It (blog): http://tm.durusau.net
Homepage: http://www.durusau.net
Twitter: patrickDurusau
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQIcBAEBAgAGBQJTAsJ1AAoJEAudyeI2QFGo7o4QAInlD4p6q1j5zCphA8lHcno0
Cxs4QE1rkYnlKG6WQq2Yx3vLtGB4bwkJdJqWnUaTkA5GSh5L+1haVhZ6F0/OvfRu
YJU4jAMU3u8q8+6f8Ui35l3U3vfG1Ctf3sGpUzMXVNPqEXcRXhWo3KlsQ78Z2IRY
GmXPdcXiKOAQpMWidhaEqWdcyVMs+w10Yg2h60a1J03QC+xWZnY6XoJmI6wTXtyq
M4ZVKUqGih9m1fbBgkIKk1aEgOpyu3wRxE/6D+/vV7a8O8HAFXCB7s4fC34HtGEz
N1m3zmXHwy8AdRyn8FHeGf7oyGj7+Q7nmYNcpWXFOMcOwSIRv7EsROtej7BPUap1
rk8snMaznunpsCWUVhAAmv2+HOi0NxMpVw2ZIX/VYH0bF9R+bE8u7OB62KAlMTaU
zD6opXzDoyjIlEfhOX1/z5cbEteEZnSER+H6+cmHBeOKXt+28XNK20AdIW1jncDz
yc20/n2urrS6E/iF1iOkCsCs8RQmhISSK3tpciQS1FOIm7u9oENWCbwTF0aTWrDs
xfr62ANFIsDEmez0Xh1+qQUJ2UXVgjTwac5jAkRUnU176pCxG6GOgVBPNfZktIpI
qFRTjRR6/F2MT2avukuWTLKAmNTIfKvy8IeuzpBiQImIE6nAVelODyeuzaME9IuH
FfFSQPH/FjkR8973x83X
=A2o3
-----END PGP SIGNATURE-----