SBVR12 — SBVR issue - Re-sequencing Clause 11

Problem: SBVR adheres to ISO 1087 as much as possible. Clearly evident in the structure of ISO 1087 is that no definition should appear until all terms within it have been defined (as needed). This best practice (rule) results in a logical, easy-to-follow presentation. Clause 11 of SBVR is clearly broken in this regard. The result is significant lack of clarity, making detection of errors unnecessarily difficult. The possibility of misinterpretation (or non-comprehension) by software engineers and other readers is high.

Aside: Personally I think this solution amounts to simple editing because anyone could apply the ISO 1087 rule without understanding a thing about the content. However, since some might see new headings or groupings as somehow conveying meaning – never the case in SBVR – I have nonetheless requested an issue. There are also a few choices about optimizing placement.

Note: *This issue can be resolved without using any meeting time.*

Resolution: Apply the ISO 1087 rule about sequencing vocabulary entries rigorously. This re-sequencing requires no changes in the entries themselves.

Attachments: Two files containing all Clause 11 entries are attached. One file is unchanged except that entries are numbered. The other file is re-sequenced. The entry numbers reappear in the re-sequenced file indicating the original location of each entry. Unfortunately, this working version does not use the latest version of SBVR … I did not have the source file for that. However, since no changes to the entries themselves are covered by this issue, the version used is largely immaterial to illustrate the proposed resolution. The lay-out simply needs to be re-done for the newer material.

Merger with Issue 18377