DR 13:0013: Proposed solution to "the purple ones"

[Chris Rae]

In Berlin we proposed breaking down DR 13-0013 into two DRs: one to address the editorial changes (the ones highlighted purple in the breakdown of the DR I circulated) and one to address the rest. I'm going to work with Rex next week on the mechanics of splitting the DR, but in the meantime I've written up some proposed edits to address the editorial defects.

The issue I'm addressing in the DR (https://onedrive.live.com/view.aspx/Public%20Documents/2013/DR-13-0013.docx) is:

'In a number of cases, the words "If this element" with "is omitted", "is not present" or similar are used in descriptions of attributes. These are potential sources of confusion for implementers.'

The DR then lists 32 attributes, covering 16 subsections. In some instances the text did correctly use the word "element", and in these cases I added text to the top-level element description explaining the behaviour and removed the clause from the attribute description. In some, it should have read "attribute" and I've modified the text to reflect that. In some, there was more complex inheritance rules (in styles or latent styles) and I've added text to cover that.

I believe that two of the attributes named in the DR are listed in error (@colFirst and @colLast on element bookmarkStart) and have made no changes to those attribute descriptions.

Some schema changes were necessary, but they were only to include values already specified in prose, so I believe them to still be editorial.

I've cut down the text a great deal but it's still thirteen pages and as such is most easily reviewed offline, but I'd be happy to talk through it on a  call or at the next face-to-face.

Chris
-------------- next part --------------
A non-text attachment was scrubbed...
Name: changes for DR-13-0013 (purple ones only).docx
Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Size: 53668 bytes
Desc: changes for DR-13-0013 (purple ones only).docx
URL: <http://mailman.vse.cz/pipermail/sc34wg4/attachments/20140424/eea43d59/attachment-0001.docx>