Delete unnecessary Conventions
attribute in two examples
#349
Labels
change agreed
Issue accepted for inclusion in the next version and closed
defect
Conventions text meaning not as intended, misleading, unclear, has typos, format or language errors
Linked pull request
Dear all
I propose the deletion of the
Conventions
attribute from Examples 7.15 and 7.16 in Section 7.5 on Geometries. Although it may seem odd to delete information, I think the attribute here isn't really informative. Including it is a defect, and removing it is a correction. My reasons for thinking this are:These are the only examples in the whole document that contain the
Conventions
attribute (as has been discussed elsewhere), so it's inconsistent. We couldn't make the document consistent by includingConventions
in all other examples, because most of them are just fragments of CDL. They don't show global attributes, which would be irrelevant and hence distracting to the point being illustrated.Keeping
Conventions
only in these two examples might imply it was particularly significant, more than in all other examples which don't include it. This isn't so. I guess that it might have been included to make the point, at the time the proposal was drafted, that the feature didn't exist in the version that was the present release at that time. Maybe @dblodgett can remember?Best wishes
Jonathan
The text was updated successfully, but these errors were encountered: