The description of a property may occurs tens of times in the document with identical text. For instance, the description of color, themeColor, themeShade, themeTint appears 37 times identically in the document.
This inflates the document and makes everybody’s work 37 times harder than necessary.
This inflates the document and makes everybody’s work 37 times harder than necessary.
Remove all identical occurrences except one and replace physical presence by reference to the unique occurrence.
This should be done for all property descriptions, not only those mentioned as examples. Doing so will reduce drastically the length of the document and make it much more acceptable.
This should be done for all property descriptions, not only those mentioned as examples. Doing so will reduce drastically the length of the document and make it much more acceptable.
This is very important.
Whole spec
ed
Proposed Disposition of DIS 29500 Comment IL-0033 (Modified: 2008-01-04) We agree that the repetition of attribute definitions creates some additional work for reviewers, but the existing approach was designed with the implementer in mind. Although the repetition of certain attribute definitions adds to the length of DIS29500, these definitions are useful to implementers and help them get quick answers without the need to refer to a separate location within the document (or possibly a separate document). Similar Comments: CZ-0003 , US-0265
