Issue 15151: new SBVR issue - relationship of 'vocabulary' and 'rulebook' (sbvr-rtf) Source: International Business Machines (Mr. Mark H. Linehan, mlinehan(at)us.ibm.com) Nature: Uncategorized Issue Severity: Summary: 'Vocabulary' is defined in clause 11.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. -------------------------------- Resolution: Revised Text: Actions taken: March 25, 2010: received issue Discussion: End of Annotations:===== ubject: new SBVR issue - relationship of 'vocabulary' and 'rulebook' X-KeepSent: 792816A6:FD3A77AA-852576F1:0051B601; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.0.2 HF623 January 16, 2009 From: Mark H Linehan Date: Thu, 25 Mar 2010 11:28:37 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.0.2FP4|December 10, 2009) at 03/25/2010 11:28:38, Serialize complete at 03/25/2010 11:28:38 'Vocabulary' is defined in clause 11.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 X-Yahoo-SMTP: MhfrpU2swBDLgYiYhNQDHBu0cE4o.vu2We1FRN9o X-YMail-OSG: ZGhUrI8VM1lbLLGC8g9SIMpRbqgyxSVukvTCjUvWz_QMW17NCoSSkt3PKZqlGxCliC7Sn5U8LI7StC70yW7FlC0LOBww9VMgpCz2o4h4KYZEUfJxhlE6zMsS30cWXB3UmT630jwymaDwNz6syE0nmbXMsMrPLl1WXEssmfSK9xiG.mJ8QbldG3lJ5CoYzu5iUC4M2lxfWR9mmWSybPk_LcZF6fvi9js2Xf_MG_b4mJjTf2AyT431WqoD3FFvaMODpGIbPLMnflEDLZcfjaW0Ne71Ql7ieq8- X-Yahoo-Newman-Property: ymail-3 X-Mailer: QUALCOMM Windows Eudora Version 7.1.0.9 Date: Thu, 25 Mar 2010 11:28:56 -0500 To: Mark H Linehan , sbvr-rtf@omg.org, juergen@omg.org From: "Ronald G. Ross" Subject: Re: new SBVR issue - relationship of 'vocabulary' and 'rulebook' At 10:28 AM 3/25/2010, Mark H Linehan wrote: 'Vocabulary' is defined in clause 11.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. In terms of the existing specification, I believe the only thing you could say with absolute certainty is that a vocabulary would never have behavioral (deontic) elements of guidance, whereas a rulebook almost certainly would. Beyond that, it's a matter of practice ... whether you think about definitional (alethic) elements of guidance as part of definitions (vocabulary), or as guidance, more or less separate from definitions. Actually, most real-world rulebooks (for sports) I've looked at do some of both with their definitional (alethic) elements of guidance (i.e., embed some in definitions, and externalize others as elements of guidance on their own). On the other hand, we call SBVR a "vocabulary" mainly because it has no behavioral (deontic) elements of guidance, even though it often does have more or less separate necessities (i.e., separate from definitions per se). Ron -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 To: sbvr-rtf@omg.org Subject: Issue 15151 X-KeepSent: 012B1811:A85BE680-8525774D:0074B717; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.0.2 HF623 January 16, 2009 From: Mark H Linehan Date: Fri, 25 Jun 2010 17:23:57 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.0.2FP4|December 10, 2009) at 06/25/2010 17:23:58 During yesterday's RTF meeting, I agreed to prepare a resolution for issue 15151 that adds informative text explaining the difference between "rulebook" and "vocabulary". I have done that in this version, also including "terminological dictionary" in the discussion. In doing this, I have noticed that the specification omits the implied verb concepts "vocabulary includes designation" and "terminological dictionary includes representation". I think this means that the clause 13 XMI exchange format cannot support vocabularies and terminological dictionaries as intended. If I'm right, then we need a more significant change than is proposed in this resolution. It's also obvious from the proposed resolution that there is significant overlap among these three concepts. The relationship between "terminological dictionary" and "vocabulary" is captured by "terminological dictionary presents vocabulary". And we have "rulebook uses vocabulary". Would it make sense to say that "rulebook includes terminological dictionary" and delete "rulebook includes representation"? This way, a rulebook could include a terminological dictionary and/or a body of shared guidance, and it would get the representations through the terminological dictionary. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Issue 15151.doc Disposition: Resolved OMG Issue No: 15151 Title: Relationship of 'vocabulary' and 'rulebook' Source: Mark H. Linehan, IBM Research, mlinehan@us.ibm.com Summary: 'Vocabulary' is defined in clause 11.1.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. Proposed resolution: A vocabulary contains only designations, whereas a rulebook contains all representations (designations, definitions, notes, examples, etc.) A rulebook may also include a body of shared guidance which contains elements of guidance. The issue is addressed by adding clarifying informative text to the specification. Revised Text: Add a note under vocabulary in section 11.1.1.3 on page 133: Note: A vocabulary contains only designations and fact type forms. Contrast a terminological dictionary, which further adds definitions, descriptions, etc. A rulebook includes everything that is in a terminological dictionary, plus a body of shared guidance. Add a note under terminological dictionary in section 11.1.1.3 on page 134: Note: Contrast a terminological dictionary with a rulebook, which may include a body of shared guidance containing operative business rules. Add a note under rulebook in section 11.2.2.4 on page 155: Note: A rulebook contains all representations (designations, fact type forms, definitions, notes, descriptive examples, etc.) in a body of shared meaning. A rulebook may also include a body of shared guidance, which contains elements of guidance. Contrast a rulebook with a vocabulary, which contains only designations and fact type forms. Also contrast a terminological dictionary, which contains everything that is in a rulebook except a body of shared guidance. Disposition: Resolved From: Don Baisley To: Mark H Linehan , "sbvr-rtf@omg.org" Subject: RE: Issue 15151 Thread-Topic: Issue 15151 Thread-Index: AQHLFKzlgw9oXZSrHUOsREkmgLi865KTQR+g Date: Fri, 25 Jun 2010 22:43:33 +0000 Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: Mark.s general approach to resolving the issue is fine. However, his added notes mistakenly describe a rulebook as containing guidance. The notes should say that a rulebook contains representations (e.g., statements). Rather than .plus a body of shared guidance., a note could say something like, .plus guidance statements representing a body of shared guidance.. Regarding Mark.s point about the .includes. verb concept: .vocabulary. gets it from .set. where it is explicitly defined. Regards, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Friday, June 25, 2010 2:24 PM To: sbvr-rtf@omg.org Subject: Issue 15151 During yesterday's RTF meeting, I agreed to prepare a resolution for issue 15151 that adds informative text explaining the difference between "rulebook" and "vocabulary". I have done that in this version, also including "terminological dictionary" in the discussion. In doing this, I have noticed that the specification omits the implied verb concepts "vocabulary includes designation" and "terminological dictionary includes representation". I think this means that the clause 13 XMI exchange format cannot support vocabularies and terminological dictionaries as intended. If I'm right, then we need a more significant change than is proposed in this resolution. It's also obvious from the proposed resolution that there is significant overlap among these three concepts. The relationship between "terminological dictionary" and "vocabulary" is captured by "terminological dictionary presents vocabulary". And we have "rulebook uses vocabulary". Would it make sense to say that "rulebook includes terminological dictionary" and delete "rulebook includes representation"? This way, a rulebook could include a terminological dictionary and/or a body of shared guidance, and it would get the representations through the terminological dictionary. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com To: sbvr-rtf@omg.org Subject: RE: Issue 15151 X-KeepSent: 2EC630E7:DCE65383-85257750:00459103; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.0.2 HF623 January 16, 2009 From: Mark H Linehan Date: Mon, 28 Jun 2010 08:44:04 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.0.2FP4|December 10, 2009) at 06/28/2010 08:44:10 I updated the proposed issue resolution to respond to Don's point. I still think we are missing an "includes" fact type that would permit the XMI exchange format to include "representations" in "terminological dictionary". I also think that "rulebook", "terminological dictionary", and "vocabulary" should have an explicit superset-subset relationship but I guess that would have to be an SBVR v2 change. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Don Baisley 06/25/2010 06:43 PM To Mark H Linehan/Watson/IBM@IBMUS, "sbvr-rtf@omg.org" cc Subject RE: Issue 15151 Markâs general approach to resolving the issue is fine. However, his added notes mistakenly describe a rulebook as containing guidance. The notes should say that a rulebook contains representations (e.g., statements). Rather than âplus a body of shared guidanceâ, a note could say something like, âplus guidance statements representing a body of shared guidanceâ. Regarding Markâs point about the âincludesâ verb concept: âvocabularyâ gets it from âsetâ where it is explicitly defined. Regards, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Friday, June 25, 2010 2:24 PM To: sbvr-rtf@omg.org Subject: Issue 15151 During yesterday's RTF meeting, I agreed to prepare a resolution for issue 15151 that adds informative text explaining the difference between "rulebook" and "vocabulary". I have done that in this version, also including "terminological dictionary" in the discussion. In doing this, I have noticed that the specification omits the implied verb concepts "vocabulary includes designation" and "terminological dictionary includes representation". I think this means that the clause 13 XMI exchange format cannot support vocabularies and terminological dictionaries as intended. If I'm right, then we need a more significant change than is proposed in this resolution. It's also obvious from the proposed resolution that there is significant overlap among these three concepts. The relationship between "terminological dictionary" and "vocabulary" is captured by "terminological dictionary presents vocabulary". And we have "rulebook uses vocabulary". Would it make sense to say that "rulebook includes terminological dictionary" and delete "rulebook includes representation"? This way, a rulebook could include a terminological dictionary and/or a body of shared guidance, and it would get the representations through the terminological dictionary. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Issue 151511.doc Disposition: Resolved OMG Issue No: 15151 Title: Relationship of 'vocabulary' and 'rulebook' Source: Mark H. Linehan, IBM Research, mlinehan@us.ibm.com Summary: 'Vocabulary' is defined in clause 11.1.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. Proposed resolution: A vocabulary contains only designations, whereas a rulebook contains all representations (designations, definitions, notes, examples, etc.) A rulebook may also include representations of the elements of guidance in a body of shared guidance. A terminological dictionary contains representations of only structural aspects. The issue is addressed by adding clarifying informative text to the specification. Revised Text: Add a note under vocabulary in section 11.1.1.3 on page 133: Note: A vocabulary contains only designations and fact type forms. Contrast a terminological dictionary, which further adds definitions, descriptions, etc. A rulebook includes everything that is in a terminological dictionary, plus representations of operative business rules in a body of shared guidance. Add a note under terminological dictionary in section 11.1.1.3 on page 134: Note: Contrast a terminological dictionary with a rulebook, which may include representations of operative business rules in a body of shared guidance. Add a note under rulebook in section 11.2.2.4 on page 155: Note: A rulebook contains representations (designations, fact type forms, definitions, notes, descriptive examples, etc.) of all meanings of a body of shared meanings. This can include representations of elements of guidance when a body of shared guidance is included in a body of shared meanings. Contrast a rulebook with a vocabulary, which contains only designations and fact type forms. Also contrast a terminological dictionary, which contains everything that is in a rulebook except representations of operative business rules. Disposition: Resolved From: Don Baisley To: Mark H Linehan , "sbvr-rtf@omg.org" Subject: RE: Issue 15151 Thread-Topic: Issue 15151 Thread-Index: AQHLFKzlgw9oXZSrHUOsREkmgLi865KTQR+ggASKDgD//8ZLcA== Date: Mon, 28 Jun 2010 16:36:42 +0000 Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: Mark, You are correct that a fact type is missing for .terminological dictionary includes representation.. A terminological dictionary is not defined to be a set (which makes sense since it is structured), so it does not get the .includes. defined on sets. In the editing instructions, please make clear where the new notes are to be added with respect to existing content. I think you intend for all these new notes to be added at the end of their respective entries. Thanks, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Monday, June 28, 2010 5:44 AM To: sbvr-rtf@omg.org Subject: RE: Issue 15151 I updated the proposed issue resolution to respond to Don's point. I still think we are missing an "includes" fact type that would permit the XMI exchange format to include "representations" in "terminological dictionary". I also think that "rulebook", "terminological dictionary", and "vocabulary" should have an explicit superset-subset relationship but I guess that would have to be an SBVR v2 change. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Don Baisley 06/25/2010 06:43 PM To Mark H Linehan/Watson/IBM@IBMUS, "sbvr-rtf@omg.org" cc Subject RE: Issue 15151 Mark.s general approach to resolving the issue is fine. However, his added notes mistakenly describe a rulebook as containing guidance. The notes should say that a rulebook contains representations (e.g., statements). Rather than .plus a body of shared guidance., a note could say something like, .plus guidance statements representing a body of shared guidance.. Regarding Mark.s point about the .includes. verb concept: .vocabulary. gets it from .set. where it is explicitly defined. Regards, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Friday, June 25, 2010 2:24 PM To: sbvr-rtf@omg.org Subject: Issue 15151 During yesterday's RTF meeting, I agreed to prepare a resolution for issue 15151 that adds informative text explaining the difference between "rulebook" and "vocabulary". I have done that in this version, also including "terminological dictionary" in the discussion. In doing this, I have noticed that the specification omits the implied verb concepts "vocabulary includes designation" and "terminological dictionary includes representation". I think this means that the clause 13 XMI exchange format cannot support vocabularies and terminological dictionaries as intended. If I'm right, then we need a more significant change than is proposed in this resolution. It's also obvious from the proposed resolution that there is significant overlap among these three concepts. The relationship between "terminological dictionary" and "vocabulary" is captured by "terminological dictionary presents vocabulary". And we have "rulebook uses vocabulary". Would it make sense to say that "rulebook includes terminological dictionary" and delete "rulebook includes representation"? This way, a rulebook could include a terminological dictionary and/or a body of shared guidance, and it would get the representations through the terminological dictionary. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com To: sbvr-rtf@omg.org Subject: RE: Issue 15151 X-KeepSent: 49A144DB:51235332-85257750:006BF4F1; type=4; name=$KeepSent X-Mailer: Lotus Notes Release 8.0.2 HF623 January 16, 2009 From: Mark H Linehan Date: Mon, 28 Jun 2010 15:40:30 -0400 X-MIMETrack: Serialize by Router on D01MC604/01/M/IBM(Release 8.0.2FP4|December 10, 2009) at 06/28/2010 15:40:32 OK, I revised the resolution to specify that the new notes come at the end of the glossary entries, and to add âterminological dictionary includes representationâ. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Don Baisley 06/28/2010 12:36 PM To Mark H Linehan/Watson/IBM@IBMUS, "sbvr-rtf@omg.org" cc Subject RE: Issue 15151 Mark, You are correct that a fact type is missing for âterminological dictionary includes representationâ. A terminological dictionary is not defined to be a set (which makes sense since it is structured), so it does not get the âincludesâ defined on sets. In the editing instructions, please make clear where the new notes are to be added with respect to existing content. I think you intend for all these new notes to be added at the end of their respective entries. Thanks, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Monday, June 28, 2010 5:44 AM To: sbvr-rtf@omg.org Subject: RE: Issue 15151 I updated the proposed issue resolution to respond to Don's point. I still think we are missing an "includes" fact type that would permit the XMI exchange format to include "representations" in "terminological dictionary". I also think that "rulebook", "terminological dictionary", and "vocabulary" should have an explicit superset-subset relationship but I guess that would have to be an SBVR v2 change. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Don Baisley 06/25/2010 06:43 PM To Mark H Linehan/Watson/IBM@IBMUS, "sbvr-rtf@omg.org" cc Subject RE: Issue 15151 Markâs general approach to resolving the issue is fine. However, his added notes mistakenly describe a rulebook as containing guidance. The notes should say that a rulebook contains representations (e.g., statements). Rather than âplus a body of shared guidanceâ, a note could say something like, âplus guidance statements representing a body of shared guidanceâ. Regarding Markâs point about the âincludesâ verb concept: âvocabularyâ gets it from âsetâ where it is explicitly defined. Regards, Don From: Mark H Linehan [mailto:mlinehan@us.ibm.com] Sent: Friday, June 25, 2010 2:24 PM To: sbvr-rtf@omg.org Subject: Issue 15151 During yesterday's RTF meeting, I agreed to prepare a resolution for issue 15151 that adds informative text explaining the difference between "rulebook" and "vocabulary". I have done that in this version, also including "terminological dictionary" in the discussion. In doing this, I have noticed that the specification omits the implied verb concepts "vocabulary includes designation" and "terminological dictionary includes representation". I think this means that the clause 13 XMI exchange format cannot support vocabularies and terminological dictionaries as intended. If I'm right, then we need a more significant change than is proposed in this resolution. It's also obvious from the proposed resolution that there is significant overlap among these three concepts. The relationship between "terminological dictionary" and "vocabulary" is captured by "terminological dictionary presents vocabulary". And we have "rulebook uses vocabulary". Would it make sense to say that "rulebook includes terminological dictionary" and delete "rulebook includes representation"? This way, a rulebook could include a terminological dictionary and/or a body of shared guidance, and it would get the representations through the terminological dictionary. -------------------------------- Mark H. Linehan STSM, Model Driven Business Transformation IBM Research phone: (914) 784-7002 or IBM tieline 863-7002 internet: mlinehan@us.ibm.com Issue 15151v3.doc Disposition: Resolved OMG Issue No: 15151 Title: Relationship of 'vocabulary' and 'rulebook' Source: Mark H. Linehan, IBM Research, mlinehan@us.ibm.com Summary: 'Vocabulary' is defined in clause 11.1.1.3 as "set of designations and fact type forms primarily drawn from a single language to express concepts within a body of shared meanings ". 'Rulebook' is defined in clause 11.2.2.4 as "the set of representations determined by a given speech community to represent in its language all meanings in its body of shared meanings ". How does 'vocabulary' relate to 'rulebook'? When would an SBVR tool vendor use one or the other? The specification should either explain why it defines both these two concepts and when one would use one versus the other. Proposed resolution: A vocabulary contains only designations, whereas a rulebook contains all representations (designations, definitions, notes, examples, etc.) A rulebook may also include representations of the elements of guidance in a body of shared guidance. A terminological dictionary contains representations of only structural aspects. The issue is addressed by adding clarifying informative text to the specification. Revised Text: Add a note after the existing captions for vocabulary in section 11.1.1.3 on page 133: Note: A vocabulary contains only designations and fact type forms. Contrast a terminological dictionary, which further adds definitions, descriptions, etc. A rulebook includes everything that is in a terminological dictionary, plus representations of operative business rules in a body of shared guidance. Add a note after the existing captions for terminological dictionary in section 11.1.1.3 on page 134: Note: Contrast a terminological dictionary with a rulebook, which may include representations of operative business rules in a body of shared guidance. Add a new entry after "terminological dictionary" in section 11.1.1.3 on page 134: terminological dictionary includes representation Definition: the representation is an element of the terminological dictionary Synonymous Form: representation is included in terminological dictionary Add a note after the existing captions for rulebook in section 11.2.2.4 on page 155: Note: A rulebook contains representations (designations, fact type forms, definitions, notes, descriptive examples, etc.) of all meanings of a body of shared meanings. This can include representations of elements of guidance when a body of shared guidance is included in a body of shared meanings. Contrast a rulebook with a vocabulary, which contains only designations and fact type forms. Also contrast a terminological dictionary, which contains everything that is in a rulebook except representations of operative business rules. Disposition: Resolved internet: mlinehan@us.ibm.com