${taskforce.name} Avatar
  1. OMG Task Force

AB Process Subcommittee — Open Issues

  • Key: ABPSC
  • Issues Count: 42
Open Closed All
Issues not resolved

Issues Summary

Key Issue Reported Fixed Disposition Status
ABPSC-60 Provide process for model-originated Specifications ABPSC 3.3 open
ABPSC-63 Reform Finalization Process - No separate FTF and FTF-2 ABPSC 3.3 open
ABPSC-67 Formalize language requirements in our templates ABPSC 3.3 open
ABPSC-66 Firm up LOI Requirements for RFC ABPSC 3.3 open
ABPSC-65 Revise Revision Report Generator to Satisfy Community Needs ABPSC 3.3 open
ABPSC-64 Resolve double meaning of "Ancillary" ABPSC 3.3 open
ABPSC-62 Document categories are not specified in P&P ABPSC 3.3 open
ABPSC-61 RFP template references very dated specs ABPSC 3.3 open
ABPSC-58 Provide process for text-originated specifications ABPSC 3.3 open
ABPSC-59 Standards need to be decomposable ABPSC 3.3 open
ABPSC-55 Better support Diversity and Inclusion issues in Jira ABPSC 3.3 open
ABPSC-50 Need clear policy regarding review of an RFP by the AB ABPSC 3.3 open
ABPSC-19 RFPs shall be presented and discussed at least one meeting prior to the issuing meeting ABPSC 3.3 open
ABPSC-57 Rename the term of 'w***e ballot' ABPSC 3.3 open
ABPSC-47 Revisit guidance of using camelCase in formation of names and use in case insensitive systems ABPSC 3.3 open
ABPSC-33 URLs, URIs and namespaces for CMMN 1.1 XSDs are not aligned CMMN 1.1 open
ABPSC-56 Document the 'w***e' ballot process ABPSC 3.3 open
ABPSC-54 Need a new canonical XMI validation capability ABPSC 3.3 open
ABPSC-22 BCQ requested too frequently, and unclear in the P&P ABPSC 3.3 open
ABPSC-53 Codify Working Groups in P&P ABPSC 3.3 open
ABPSC-52 Develop a well-formed replacement for ongoing 'open' Working Groups. ABPSC 3.3 open
ABPSC-45 Specification Catalog shall provide links to members of a family of specifications ABPSC 3.3 open
ABPSC-32 Specification Catalog is Missing Machine-Readable Files ABPSC 3.3 open
ABPSC-46 RFI 'Lite' as alternative to traditional RFI process ABPSC 3.3 open
ABPSC-29 Clarify meaning of 'attendance' to include online presence ABPSC 3.3 open
ABPSC-35 P&P 3.7.3 Clarification ABPSC 3.3 open
ABPSC-36 Discussion Paper cover disclaimer ABPSC 3.3 open
ABPSC-14 Use of OMG LOI Template should be a requirement, not a suggestion ABPSC 3.3 open
ABPSC-18 Boilerplate includes ISO 8859-1 as a document format ABPSC 3.3 open
ABPSC-10 AB Email vote closure trigger is not well-formed. ABPSC 3.3 open
ABPSC-12 Review date limitation for allowing RTFs to extend functionality ABPSC 3.3 open
ABPSC-11 "American English" requirement is not in P&P ABPSC 3.3 open
ABPSC-4 P&P 3.7.4.1 does not exist ABPSC 3.3 open
ABPSC-25 Revisit copyright license in RFI template ABPSC 3.3 open
ABPSC-8 Derivative Templates Need Updating ABPSC 3.3 open
ABPSC-40 The Specification Lifecycle lacks transparency ABPSC 3.3 open
ABPSC-9 There is no way to recall (deprecate, or whatever a Process (RFP...) ABPSC 3.3 open
ABPSC-39 Links to RFPs needed in Work-in-Progress Sections, also valuable in Spec Catalog ABPSC 3.3 open
ABPSC-28 P&P needs to be more explicit about which documents are subject to the 4 wk rule ABPSC 3.3 open
ABPSC-15 Deadline for submission of request for Vote to Vote should be added to the P&P ABPSC 3.3 open
ABPSC-13 Clarification needed on Submitters, Supporters, and Contributors ABPSC 3.3 open
ABPSC-7 Need a new process - Request for Curation Inclusion (RFCI) Process ABPSC 3.3 open

Issues Descriptions

Provide process for model-originated Specifications

  • Key: ABPSC-60
  • Status: open  
  • Source: Object Management Group ( Mr. Mike Bennett)
  • Summary:

    Need detailed procedure for how to satisfy the following two process requirements, for specifications or specification content that originates from a model rather than as written text.

    1. What xTF members view when they vote on a proposed change
    2. What the xTF Report Convenience Document (change bars) presents in order to show each change since the prior version, each annotated with the Jira for the change.

  • Reported: ABPSC 3.3 — Wed, 27 Sep 2023 16:21 GMT
  • Updated: Fri, 22 Mar 2024 17:37 GMT

Reform Finalization Process - No separate FTF and FTF-2

  • Key: ABPSC-63
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    Splitting the finalization process into FTF and FTF-2 (as separate taskforces) is highly counter-productive. In many FTFs, JIRA and other electronic tools are used to organize, control, and facilitate the finalization process. This includes interactive discussions and design work to reach the best solution in collaborative work of the FTF members. Splitting this continuous work arbitrarily into two logistically separate task forces at the 14 months mark is damaging for the efficiency of this process. It would be much favorable to have ONE FTF, with constant membership and constant work environment throughout the whole finalization process. A checkpoint and intermediate reporting shall be introduced after 14 months, and the extension to 24 months shall be dependent on AB endorsement of the checkpoint report, and TC vote.
    This scheme preserves the timing idea of FTF/FTF-2, but preserves the continuous work environment for the FTF.

  • Reported: ABPSC 3.3 — Tue, 20 Feb 2024 02:12 GMT
  • Updated: Fri, 1 Mar 2024 18:21 GMT

Formalize language requirements in our templates

  • Key: ABPSC-67
  • Status: open  
  • Source: Object Management Group ( Mr. Mike Bennett)
  • Summary:

    The OMG working language is British and Commonwealth English, as this is the required language for ISO specifications. For consistency we have carried this language policy through to the RFP, which does not go through the ISO PAS process. Meanwhile not all RFC are expected to go through ISO.

    At present, our RFP Template uses the alternative British endings of 'ise'. whereas ISO requires that also-British 'ize' endings on certain (not not all) kinds of words that take 'ize' in the US.

  • Reported: ABPSC 3.3 — Mon, 26 Feb 2024 16:46 GMT
  • Updated: Tue, 27 Feb 2024 04:47 GMT

Firm up LOI Requirements for RFC

  • Key: ABPSC-66
  • Status: open  
  • Source: Object Management Group ( Mr. Mike Bennett)
  • Summary:

    The P&P does not formally require an LOI for RFCs, although we proceed as though it does. Instead the P&P gives a list of things that should accompany an RFC submission, and our RFC LOI Template satisfies those requirements.

    The list is vaguer than the LOI, particularly for the requirement to grant OMG a perpetual, nonexclusive, royalty-free, paid up, worldwide license to copy and distribute.

  • Reported: ABPSC 3.3 — Mon, 26 Feb 2024 16:41 GMT
  • Updated: Mon, 26 Feb 2024 16:41 GMT

Revise Revision Report Generator to Satisfy Community Needs

  • Key: ABPSC-65
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    The recently revised Revision Report Administration Page provides a number of good improvements, but it is still very unintuitive, and compared to the previous version, fails to satisfy the community and process needs.

    Clear and understandable input fields are required for the following information. Each input filed must have a clear and specific title, leaving no question about purpose and format:

    (1) Specification Information:
    (1a) Exact Specification Title
    (1b) Specification Version [ no "Alpha", "Beta", etc ]
    (1c) Specification Acronym
    (1d) Specification Version Stamp

    Document Information Note, there may be multi-volume specifications. The input format must support that.

    (2) Specification Document Input (for each specification volume):
    (2a) Exact name of the Specification Volume [ with implied document number assignment ]

    Alternatively, input of a multi-volume specification as ZIP archive shall be supported:

    (2b) ZIP Archive Name [ with implied document number assignment ]
    (2c) File Name and Exact Volume Title for each specification volume [ repeated ]

    Note, in a multi-document specification, not every document may have changed during the revision process, therefore it would be very helpful for the specification reviewer if the changed documents could be flagged.

    The exact same facilities as under (2) must be provided for change marked specification volumes.

    The creation of ancillary attachment files / archives for the purpose of the revision report shall be transparent and invisible to the user

    Machine Consumable Files:

    All Machine Consumable Files MUST have a Version Stamp URL. This is necessary for version management, until the OMG adopts a professional version management scheme, like GIT, etc. For files that require a different (additional) URL, an optional URL filed shall be provided by the input facility. Single File Input and ZIP Archive Input shall be supported. The below described Input Facility shall be provided two times with identical layout. Once for NORMATIVE files, and once for INFORMATIVE files.

    (3) Machine Consumable Files Input
    (3a) File Name [ with implied document number allocation ]
    (3b) File Description
    (3c) Alternative URL [ optional ]
    (3d) Version Stamp Override [ optional - accommodating reuse of files from previous versions ]

    For Multi-File Input as ZIP Archive:
    (3e) ZIP Archive Name [ with implied document number allocation ]
    Then repeated input (3a) to (3d) for each file in the ZIP Archive.

    As stated, this input facility must exist twice with identical layout, for NORMATIVE and INFORMATIVE Machine Consumable Files.

    Specification Maintenance Support.
    To facilitate specification maintenance, a specification maintenance archive is required. It is currently called "Ancillary" but shall be called "Maintenance" to avoid confusion with the ancillary attachments of the report.

    The Maintenance Archive shall have a private URL with the SAME Acronym and Version Stamp as the corresponding Normative Machine Consumable Files of the Specification to allow unambiguous association.

    Only the Maintenance Archive file name [ with implied document number allocation ] is needed as input field.

    However, the Maintenance Archive must contain at least:
    (4a) SVG files for all images
    (4b) Editable Model sources - if models are used in specification
    (4c) Document sources - if needed for reproduction
    (4e) Other necessary items

  • Reported: ABPSC 3.3 — Fri, 23 Feb 2024 00:15 GMT
  • Updated: Fri, 23 Feb 2024 00:15 GMT

Resolve double meaning of "Ancillary"

  • Key: ABPSC-64
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    There is a conceptual confusion about "Ancillary":

    (a) The report generates an “ancillary archive” which contains all the attachment stuff from the JIRA process.

    (b) The Taskforce Chair is required to provide Maintenance Material, which are SVG images, Models, Document Sources, etc., and that is also called an “ancillary archive”

    The report administration page apparently does not understand this distinction. Also, to resolve this confusion and double-usage of “ancillary”, I strongly recommend the introduction of category “Maintenance”, reserved for specification maintenance material, replacing that usage of “ancillary” and be as private as all the ancillary files before.

    In addition, Specification Maintenance Archives must have the Version Stamp in their file name (or otherwise associated with the file), so that the particular maintenance archive can be unambiguously associated with the corresponding specification version. Since at least the model inside the maintenance archive is directly associated with machine readable files, the Version Stamp is preferred over the Specification Version.

  • Reported: ABPSC 3.3 — Thu, 22 Feb 2024 20:00 GMT
  • Updated: Thu, 22 Feb 2024 20:00 GMT

Document categories are not specified in P&P

  • Key: ABPSC-62
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    Documents within specifications are explicitly categorized as "Normative", "Informative", etc. This categorization is used within the Jira system, and is generally accepted by membership.

    There is no document within the OMG that defines this set of categories or describes when they are appropriate.

  • Reported: ABPSC 3.3 — Mon, 4 Dec 2023 22:18 GMT
  • Updated: Mon, 4 Dec 2023 22:18 GMT

RFP template references very dated specs

  • Key: ABPSC-61
  • Status: open  
  • Source: Adaptive ( Mr. Pete Rivett)
  • Summary:

    This is not only in the list of references in B.1 but in section 2
    For example the following, while not formally retired, are not mentioned or reused in any meaningful way:

    • section 2 lists mappings in EDOC and to COM. And conversely does not list far more widely used mappings e.g for GraphQL, JSON, REST.
    • section 2 again lists dated services such as Naming Service and Trading Object Service
    • section 2 lists OMA which I think is pretty irrelevant
      In summary, I think a knowledgeable team of MARS and other experts should clean it up and use more recent and relevant examples.
  • Reported: ABPSC 3.3 — Fri, 1 Dec 2023 01:03 GMT
  • Updated: Fri, 1 Dec 2023 01:03 GMT

Provide process for text-originated specifications

  • Key: ABPSC-58
  • Status: open  
  • Source: Object Management Group ( Mr. Mike Bennett)
  • Summary:

    Some FTFs and RTFs maintain specification content in a textual format with changes managed in a version control system (GitHub). Example source formats include Markdown and LaTeX.

    Identify whether any P&P changes are needed to support this. In addition, provide detailed procedural documentation and guidance specific to this scenario.

    Note that while current practice is to record all change proposals as manual editor instructions, the P&P calls only for textual change information.

  • Reported: ABPSC 3.3 — Mon, 17 Jul 2023 15:09 GMT
  • Updated: Mon, 16 Oct 2023 19:22 GMT

Standards need to be decomposable

  • Key: ABPSC-59
  • Status: open  
  • Source: Boeing ( Ms. Sharon Fitzsimmons)
  • Summary:

    View specification for <<Standards>> elements do not allow for directed composition into other <<Standards>>. Specification for <<Standards>> elements do not specify a part property.
    This is needed because many ConformsTo relationships conform to only a specific part of a standard, rather than the entire standard. Traceability is enhanced by allowing for a UAF Element to ConformTo a standard at a lower level than the parent.

  • Reported: ABPSC 3.3 — Mon, 25 Sep 2023 10:17 GMT
  • Updated: Mon, 25 Sep 2023 10:17 GMT

Better support Diversity and Inclusion issues in Jira

  • Key: ABPSC-55
  • Status: open  
  • Source: Kratos RT Logic, Inc. ( Mr. Justin Boss)
  • Summary:

    Current Jira template is not optimized for Diversity and Inclusion issues.

    Consider changing Jira to support this better. Possibly via an issue type, custom field, or label field.

    For now, I am labeling this with a 'D&I' label.

  • Reported: ABPSC 3.3 — Fri, 24 Mar 2023 13:42 GMT
  • Updated: Mon, 17 Jul 2023 15:48 GMT

Need clear policy regarding review of an RFP by the AB

  • Key: ABPSC-50
  • Status: open  
  • Source: Jackrabbit Consulting ( Mrs. Charlotte Wales)
  • Summary:

    Section 4.1 of the Hitchhiker's Guide, V7.8 includes this:

    A typical Task Force voting scenario is as follows:
    1. The Task Force meets at least once to discuss the RFP prior to any Architecture Board (AB) review. By policy, a RFP cannot be issued at the same meeting that it is first discussed.
    2. A spokesperson(s) presents the RFP to the AB at its first meeting day (by convention, Monday afternoon) for initial review.
    3. The AB may or may not request minor revisions.
    4. The RFP working group makes necessary changes (if required).
    5. AB and subsequent Task Force changes (if any) are reviewed and the vote to recommend issuance occurs in a Task Force meeting prior to the AB’s second meeting day (by convention, Thursday afternoon).
    6. The (modified) RFP is presented to the AB at its Thursday meeting with a request to vote its recommendation for issuance.

    I think item 1 needs to be added to the P&P to ensure it's not just a de facto policy – which, unless it's in the P&P – is all it is. I don't know where (Section 4.2.1?) or even how to state it in proper P&P form (in small text under item 1 in Section 4.2.1? or is that not normative?). As TF chair I've been enforcing this "policy" for years and it's not an unreasonable policy at all – even if it's only de facto. It ensures that we never have a situation in which an RFP (posted by the 4 wk deadline) is reviewed by the AB and the purported issuing TF is completely unaware of its existence or content.

    Need to also make it clear that an RFP may not be voted for issuance by the AB without first being recommended for issuance by the issuing TF via a formal vote. Unless it's stated elsewhere in the P&P, this statement in the P&P as it stands now is too weak:

    1. An RFP is usually drafted by the Task Force responsible for that
    technology area, and passed to the TF's parent TC for issuance.

    Btw "usually drafted"?? Why "usually"? Is this to cover the case where a SIG prepares an RFP and brings it to a TF to issue? Suggest adding something in small text to explain what is implied by "usually".

  • Reported: ABPSC 3.3 — Wed, 2 Nov 2022 19:07 GMT
  • Updated: Mon, 15 May 2023 23:25 GMT

RFPs shall be presented and discussed at least one meeting prior to the issuing meeting

  • Key: ABPSC-19
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    It is a (very) long standing practice to have new RFPs presented and discussed in the issuing Taskforce at least one meeting before the meeting in which the RFP is reviewed by the Architecture Board and eventually issued by the Technical Committee parent to the originating Taskforce. This common practice proved very valuable, but is nowhere mandated in the current version of the P&P.

    I suggest to insert at the appropriate place in section 4.2 of the P&P the sentence:

    "RFPs must be presented to, and discussed in, the originating Taskforce at least one meeting prior to the meeting, in which the RFP is intended to be issued by the Technical Committee parent to the originating Taskforce."

  • Reported: ABPSC 3.3 — Wed, 22 Jan 2020 03:25 GMT
  • Updated: Mon, 15 May 2023 23:25 GMT

Rename the term of 'w***e ballot'

  • Key: ABPSC-57
  • Status: open  
  • Source: Kratos RT Logic, Inc. ( Mr. Justin Boss)
  • Summary:

    The OMG uses the term of 'white ballot'. This term could be offensive to some audiences and should be officially renamed within the OMG. Perhaps 'blank ballot' could be used.

    This is related to ABPSC-56

  • Reported: ABPSC 3.3 — Fri, 24 Mar 2023 13:45 GMT
  • Updated: Wed, 26 Apr 2023 21:32 GMT

Revisit guidance of using camelCase in formation of names and use in case insensitive systems

  • Key: ABPSC-47
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    Groups have frequently used camelCasing for naming elements in specifications, but certain environments (SQL) are case-insensitive, and conversion of camelCase names into these environments is lossy.

    Consider whether camelCase can be recommended as a best practice in light of this.

  • Reported: ABPSC 3.3 — Mon, 19 Sep 2022 21:26 GMT
  • Updated: Wed, 29 Mar 2023 22:05 GMT

URLs, URIs and namespaces for CMMN 1.1 XSDs are not aligned


Document the 'w***e' ballot process

  • Key: ABPSC-56
  • Status: open  
  • Source: Kratos RT Logic, Inc. ( Mr. Justin Boss)
  • Summary:

    During OMG meetings, we often perform voting using a process that involves passing motions based on unanimous consent. This process is known as a 'w***e ballot' which is not a term that I have found in the OMG P&P or Robert Rules of Order.

    Can this process be documented officially in the P&P?

  • Reported: ABPSC 3.3 — Fri, 24 Mar 2023 13:44 GMT
  • Updated: Sun, 26 Mar 2023 22:08 GMT

Need a new canonical XMI validation capability

  • Key: ABPSC-54
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    The current version is not functioning properly and is essential for specification validation.

  • Reported: ABPSC 3.3 — Thu, 23 Mar 2023 18:57 GMT
  • Updated: Thu, 23 Mar 2023 23:16 GMT

BCQ requested too frequently, and unclear in the P&P

  • Key: ABPSC-22
  • Status: open  
  • Source: Adaptive ( Mr. Pete Rivett)
  • Summary:

    We seem to ask for a post-finalization BCQ in addition to the post-adoption one.
    Requiring an additional one makes little sense to me and seems somewhat of a process absurdity – is that something the Board really requires?
    Surely all that's needed is commitment that the Finalized spec is implemented.

    I also think it’s absurd to require a new BCQ for each minor revision. If someone is committed to implement the Finalized spec, it's reasonable to assume they're going to implement the spec with bugs and ambiguities fixed!

    Finally the BCQ does not ask for any more detail than "an implementation". Since most specs have several conformance points it seems useful to ask a further question about which will be provided. More useful IMO than asking about platform.

    Looking at the P&P it does not seem clear, and only seems to require one BCQ at time of adoption (which also applies to Finalization).

    For RFCs only step 6 says:
    [When the TC adoption vote begins the submitter(s) can expect to receive the
    standard Questionnaire from the Board’s Business Committee asking about
    IPR ownership of the Specification and commercial availability of
    implementations, and requesting a grant of copyright for publication.]

    The only other mention seems related to Veto power in 4.4.1.3:
    [this judgement is usually made by the Board's Business
    Committee, based upon responses to a questionnaire sent to submitters
    whilst the TC adoption recommendation vote is in progress.]

  • Reported: ABPSC 3.3 — Tue, 11 Feb 2020 14:44 GMT
  • Updated: Fri, 3 Feb 2023 19:39 GMT

Codify Working Groups in P&P

  • Key: ABPSC-53
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    As per ABPSC-52, Working Groups are currently ad hoc convenient fictions for Subgroup Chairs to organize their members into groups to perform specific tasks.

    However, without clear guardrails and guidelines, they have mutated in some cases to use cases for which they were never intended.

    It may be useful to clarify what a Working Group is, in the original intended sense, so that there are clear processes to follow. This definition should probably be added to the Subgroups (Section 3.7), perhaps with a quick definition in Section 2.

    ('Other' use cases such as described in ABPSC-52 will be supported through mechanisms yet to be determined. Defining Working Groups here does not immediately eliminate those other use cases, it simply clarifies which need special handling.)

  • Reported: ABPSC 3.3 — Tue, 24 Jan 2023 21:17 GMT
  • Updated: Wed, 25 Jan 2023 01:35 GMT

Develop a well-formed replacement for ongoing 'open' Working Groups.

  • Key: ABPSC-52
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    The OMG P&P ( https://omg.org/pp/ ) makes clear that OMG Member communications are to be kept Member only. Non-Members may be invited to join Subgroup meetings as Guests, on a case by case basis, but OMG communications are one of the benefits that Members pay for. We archive them for later reference, and they are a community resource.

    ALL official OMG groups – and therefore their mailing lists – are members-only. Period.

    Working Groups snuck through as an undefined case. Seriously, take a look in the Bylaws and P&P, they do not exist in those documents. They were only ever intended as a convenient fiction for Subgroup Chairs (Task Forces, Subcommittees, Special Interest Groups) to organize their OWN​ members into groups to perform work on behalf of the Subgroup, and to be dissolved upon completion. Without an official process, it was felt that this gave Chairs the flexibility to spin up a subset of their Subgroup, direct them, and have them report back in a more nimble fashion.

    Unfortunately, things got a little out of hand. Somewhere in the past few years, Working Groups took on a life of their own, and have been operating without meaningful process or boundaries, including inviting non-Members into OMG Members-only spaces and communications as a regular part of their operation.

    This was never the intent, nor the purpose of Working Groups, and the practice needs to be curtailed. Working Groups that continue to operate as strict subsets of the Membership are fine, and MARS DTF's Working Groups are good examples of these. (Remember, non-Members may​ be invited in, but please refer to Section 2 of the P&P for the definition of Invited Guest. It is not open season to CC or BCC at whim.)

    However, those Working Groups that are intentionally comprised of Member and non-Member individuals pose a problem. They blur the line between Member and the public, and weaken the benefits of being an OMG Member, as well as our ability to ensure adherence to the OMG IP policies that govern our communities.

    They can, of course, also serve a meaningful purpose in outreach and generating interest in OMG operations, and because of that we have been trying to find a way to support these endeavors without continuing to bruise the OMG Membership obligations that we have.

    The compromise was that newly formed WGs could – by request and approved on a case-by-case basis – be set up as open for a one-year time period, to engage with the public and generate interest, as long as the mailing list was the primary form of communication for the WG. At the end of that year, they would join the remainder of the WGs in being closed to the public, and available only to Members.

    Not all WGs have been bound by even this, however.

    We need a well-formed replacement for such cases, or consider simply enforcing the original intent of WGs, and keep them 'closed', and Members only.

  • Reported: ABPSC 3.3 — Tue, 24 Jan 2023 04:12 GMT
  • Updated: Tue, 24 Jan 2023 21:18 GMT

Specification Catalog shall provide links to members of a family of specifications

  • Key: ABPSC-45
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    Some specifications, here DDS, constitute a "family of specifications". It would be very helpful for users outside and inside OMG if the pages would provide cross-reference links. In this case, the main specification, DDS, should provide links to all related subordinate specs, like DDS-DLRL for example. In turn, the subordinate specs should provide a link to the main specification (DDS in this case).

    While using DDS here, the same scheme holds for many other families of specifications. For example MOF (SMOF, MEF, MOFOL, ...), FUML (PSCS, PSSM, ...), and the big CORBA and IDL family, (and more)

  • Reported: ABPSC 3.3 — Tue, 26 Jul 2022 19:02 GMT
  • Updated: Thu, 8 Dec 2022 13:24 GMT

Specification Catalog is Missing Machine-Readable Files

  • Key: ABPSC-32
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    Our Specification catalog is missing machine-readable files all across the board! Today alone I found XMI.xsd missing from XMI 2.5.1 and DG.xmi missing from Diagram Definition (DD) 1.1. And I had asked to restore other machine-readable files in the past...
    This is a very dangerous situation. I suggest we create an ad-hoc working group to g with a fine-tooth comb over the specification catalog. But this WG need to be people WHO KNOW THE SPECIFICATIONS. This cannot be delegated to staff. In all cases I encountered so far, all files were available from submitters / FTF / RTF, but only partially uploaded. WE NEED TO FIX THIS QUICKLY. I'm ready to help...

  • Reported: ABPSC 3.3 — Sat, 15 Aug 2020 03:03 GMT
  • Updated: Thu, 8 Dec 2022 08:10 GMT

RFI 'Lite' as alternative to traditional RFI process

  • Key: ABPSC-46
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    The RFI process described in the P&P (4.2.2) has an underlying assumption (or at least that is the perception among members) that it will be send out as a formal document, and companies will send back responses that have been legally vetted, as the 'voice of the company', on generally a months-long schedule.

    Sometimes we simply want to know what individuals think, on a shorter time-frame, and this process is not amenable to that.

    Requests have been made by three separate members on individual occasions in the past month for an 'RFI Lite', consisting of a simple web questionnaire that can be filled out by individuals not speaking on behalf of an entire company.

    Discussion needs to happen on what the changes to the existing RFI process need to be, or if this is acceptable as the P&P is written, and is instead a matter of member education and introduction of appropriate support infrastructure.

  • Reported: ABPSC 3.3 — Fri, 16 Sep 2022 22:21 GMT
  • Updated: Wed, 21 Sep 2022 22:18 GMT

Clarify meaning of 'attendance' to include online presence

  • Key: ABPSC-29
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    The P&P uses two terms to discuss the presence of a representative at a meeting (of any sort): 'attend' (present tense) and 'in person' (past tense). The meaning is clear from context that it is an individual who has engaged in a meeting.

    Given that many (most?) of our meetings now incorporate a dial-in line or online screen presentation tool of some sort, it is important for us to reflect this shift.

    Suggestion to add language specifying that online engagement (with bidirectional communication capability, voice, typed, or both) counts for purposes of attendance, including 'in person', and that attendance records should include anyone calling in to a meeting.

    Section 3.3 would be a good place to add this, as it currently does not exist.

  • Reported: ABPSC 3.3 — Thu, 12 Mar 2020 00:41 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

P&P 3.7.3 Clarification

  • Key: ABPSC-35
  • Status: open  
  • Source: cebe IT & KM ( Mr. Claude Baudoin)
  • Summary:

    The key sentence about not allowing an electronic poll concerning a referral to the parent TC of the subgroup is a little buried down this long section 3.7.3, and as we saw recently, it can be overlooked.

    Before discussing how a vote happens, and who can vote, it would seem logical to start by stating what can be voted on that way.

    The suggestion is to move the sentence “A Subgroup poll on a recommendation to the parent TC shall occur only at Subgroup meeting that is co-located with meetings of that TC” closer to the beginning – either before or after the first paragraph, which also concerns types of polls that a subgroup may conduct.

    In addition, that sentence is missing the article "a" in "... only at a Subgroup meeting ...".

  • Reported: ABPSC 3.3 — Fri, 29 Jan 2021 23:28 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

Discussion Paper cover disclaimer

  • Key: ABPSC-36
  • Status: open  
  • Source: cebe IT & KM ( Mr. Claude Baudoin)
  • Summary:

    (Note: I thought this had been entered early in the life of the ABPSC, but I can't find it)

    The boilerplate disclaimer on the cover page of a discussion paper considerably weakens the authority of the paper. While it is appropriate to tell the readers that the paper is not a specification or other Board-approved deliverable, the disclaimer fails to recognize the value of a paper developed by members, often at considerable effort, and reviewed and approved by a Task Force.

    The suggestion is to balance the current text by including more positive encouragements to treat a Discussion Paper as the well-considered opinions and/or recommendations of a body of experts. I am not proposing specific replacement text right now, but would be willing to participate in this effort if the issue is deemed to have merit.

  • Reported: ABPSC 3.3 — Fri, 29 Jan 2021 23:37 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

Use of OMG LOI Template should be a requirement, not a suggestion

  • Key: ABPSC-14
  • Status: open  
  • Source: Jackrabbit Consulting ( Mrs. Charlotte Wales)
  • Summary:

    Section 4.4 of the RFP, which describes the required Letter of Intent (LOI), treats the use of the OMG's LOI template as a suggestion.. not a requirement. This is not a good idea. Should be a requirement to ensure that the legally binding words contained in the LOI template are provided in a consistent way. In like fashion, it should be clear (stated somewhere – P&P?) that the same applies to RFC submissions – that use of the OMG's LOI template is not a suggestion but a requirement.

  • Reported: ABPSC 3.3 — Fri, 18 Oct 2019 17:06 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

Boilerplate includes ISO 8859-1 as a document format

  • Key: ABPSC-18
  • Status: open  
  • Source: Adaptive ( Mr. Pete Rivett)
  • Summary:

    The Cyber Security RFI (and I suspect most others) includes the following in section 3.2 How to Respond:

    Acceptable formats are ODF (ISO/IEC 26300), PDF (ISO 32000), ISO Latin-1 (ISO/IEC 8859-1) or MS Word .doc or .docx files.

    ISO Latin-1 is not a format but a character encoding so does not seem to fit in this list alongside the other options. Is any word processing or file format OK so long as it uses that character encoding? Why not also include UTF-8? I think we should just delete this as an option.

  • Reported: ABPSC 3.3 — Wed, 18 Dec 2019 22:56 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

AB Email vote closure trigger is not well-formed.

  • Key: ABPSC-10
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    Section 3.5.4 states that "There are no proxies for electronic polls, but neither is there is a time limit - instead, the ABC must continue gathering votes until no further voting could affect outcome."

    Since AB members may change their votes at any time prior to closure, this sets up a never-closing vote.

    By traditional fiat, a two week window has been used by the AB Chair. Codify this, or clarify the above language.

  • Reported: ABPSC 3.3 — Wed, 9 Oct 2019 18:24 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

Review date limitation for allowing RTFs to extend functionality

  • Key: ABPSC-12
  • Status: open  
  • Source: Model Driven Solutions ( Mr. Ed Seidewitz)
  • Summary:

    P&P Section 4.4.1.1, paragraph 4, defines the circumstances under which "an RTF may respond to an Issue by proposing an extension that adds functionality to a Specification." However, this allowance is limited to RTF's whose report is "delivered before 15th September 2020". The AB should review the policy as it stands well before this sunset date and decide whether to recommend that the subject policy be made permanent.

  • Reported: ABPSC 3.3 — Tue, 15 Oct 2019 23:33 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

"American English" requirement is not in P&P

  • Key: ABPSC-11
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    There is a common understanding on the AB that documents must be in English, and must be in American dialect.

    There is no such stipulation in the P&P.

  • Reported: ABPSC 3.3 — Thu, 10 Oct 2019 03:19 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

P&P 3.7.4.1 does not exist

  • Key: ABPSC-4
  • Status: open  
  • Source: Object Management Group ( Mr. Larry L. Johnson)
  • Summary:

    4.2.1 Outline of RFP Process: 

    • Step 4:  The membership list for voting on issues related to the RFP may be closed, as described in section 3.7.4.1.
    • That section does not exist... likely means to refer to Section 3.7.3 Subgroup Polls
      This is the only reference to the section number.
  • Reported: ABPSC 3.3 — Mon, 11 Mar 2019 18:29 GMT
  • Updated: Sun, 10 Jul 2022 00:05 GMT

Revisit copyright license in RFI template

  • Key: ABPSC-25
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    The current copyright license that respondents to an RFI place in their response is included in the RFI template v1.6 (omg/19-07-01).

    The current text is:

    We hereby grant OMG the right to make an unlimited number of copies of the Copyrighted Material as part of the OMG adoption process.
    We hereby grant each OMG member the limited right to make up to twenty-five (25) copies of the Copyrighted Material for review purposes only as part of the OMG adoption process.

    It has been pointed out that this makes no claim of revocability or irrevocability of the material provided in an RFI response, and that the concept of 'copies' of the material is less meaningful in the age of primarily digital documents.

    This license should be redone to reflect current distribution mechanisms, and clarify the revocability (or not) of information supplied in the response to an RFI.

  • Reported: ABPSC 3.3 — Thu, 20 Feb 2020 00:56 GMT
  • Updated: Wed, 23 Mar 2022 06:08 GMT

Derivative Templates Need Updating


The Specification Lifecycle lacks transparency

  • Key: ABPSC-40
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    We need a timeline for each specification and submission, indicating the actual state a submission/specification is in at a given point of time to allow traceability.

    While being a submission, revised submission dates provide some information about its state, same is true while in FTF. But after that are several steps until the spec ends up in the Formal Specification Catalog, and sometimes it takes significant time for these last steps, and nobody can give an answer why it takes so long and what can be done. A simple "State Machine Display" would be very helpful to see the state a document is in, and what could be done to help accelerate its processing.

  • Reported: ABPSC 3.3 — Tue, 15 Feb 2022 03:45 GMT
  • Updated: Tue, 15 Feb 2022 03:45 GMT

There is no way to recall (deprecate, or whatever a Process (RFP...)

  • Key: ABPSC-9
  • Status: open  
  • Source: Object Management Group ( Mr. Larry L. Johnson)
  • Summary:

    As it stands now an RFP remains in existence after all its deadlines are passed... its a Zompie RFP which theoretically can be reactivated by resetting its schedule... but for the most part they linger in the database as an active process; which its not.

  • Reported: ABPSC 3.3 — Fri, 10 May 2019 15:56 GMT
  • Updated: Tue, 15 Feb 2022 03:30 GMT

Links to RFPs needed in Work-in-Progress Sections, also valuable in Spec Catalog

  • Key: ABPSC-39
  • Status: open  
  • Source: 88solutions ( Mr. Manfred R. Koethe)
  • Summary:

    As soon as a submission is adopted and moves into FTF state, the link to the soliciting RFP disappears from the Work-in-Progress page, and finding the correct RFP turns often into a cumbersome search in the document repository. Therefore, every RTF and FTF section shall retain the link(s) to the responsible RFP(s).

    The same is true for the Specification Catalog. While RFPs are public documents, we may not want to make them public for formal specifications since the actual specifications may have diverged/evolved from the original requirements over time, but the member-only version shall have these links in, either the History, or in a new RFP section of the catalog entry. This would aid the work of members, and in particular the AB a lot.

  • Reported: ABPSC 3.3 — Thu, 10 Feb 2022 18:48 GMT
  • Updated: Thu, 10 Feb 2022 18:48 GMT

P&P needs to be more explicit about which documents are subject to the 4 wk rule

  • Key: ABPSC-28
  • Status: open  
  • Source: Jackrabbit Consulting ( Mrs. Charlotte Wales)
  • Summary:

    I've just today come to the embarrassed realization that I've been assuming for years (my bad!) that RFIs (issuance of) are not subject to the 4 wk rule. That folks can decide during a meeting week to prepare an RFI and get it issued that same week. And I've been spinning what I realize now is a fairy tale for years. After reviewing the P&P today (and the HH Guide), my opinion is that the P&P's handling of the 4 week rule is quite clear on the subject of submissions but with regards to documents like RFPs, RFCs, and RFIs is quite obtuse. It does not state explicitly which documents issued by a subgroup are subject to the 4 week rule – all it says is "Where a poll at a meeting requires documentation (i.e., on adoption of particular documents or based on the content of a document), one third of the Voting Members represented at the meeting may invoke the requirement that documentation supporting the poll must be available at least four weeks prior to the poll." This may be OK in the sections concerning the AB polls (Sxn 3.5.4) and DTC/PTC polls (Sxn 3.5.2) but IMHO is not OK for subgroups. One is forced to infer that "based on the content of a document" refers to things like RFPs, RFCs, and RFIs. A subgroup chair should not be forced to have to infer the intent of some obscure line in the P&P .. it should be clear. It also doesn't state clearly that the 4 wk rule applies – all it says is that somebody can choose to invoke it, if they wish.

    My suggestion is that the wording of the paragraph cited above should be changed to indicate exactly which documents are subject to the 4 week rule. Am referring here to the ones covered by "based on the content of a document" ("adoption of particular documents" clearly refers to submissions). One could also add the qualification that the 4 wk rule applies to any document voted on by a subgroup that will subsequently be voted on by the AB and TC or the TC alone. Furthermore, the wording should be more direct... clearly state the cases where a 4 wk rule applies instead of stating it indirectly (almost backwards or by exception) – "Members represented at the meeting may invoke the requirement that documentation supporting the poll must be available at least four weeks prior to the poll." This makes it sound like one can ignore the 4 wk rule unless somebody objects. In which case what kind of a rule is it?

    I know we've operated under this subtle wording for years .. but let's abandon subtlety for clear and direct. Please!

  • Reported: ABPSC 3.3 — Mon, 24 Feb 2020 20:19 GMT
  • Updated: Fri, 13 Mar 2020 00:09 GMT

Deadline for submission of request for Vote to Vote should be added to the P&P

  • Key: ABPSC-15
  • Status: open  
  • Source: Jackrabbit Consulting ( Mrs. Charlotte Wales)
  • Summary:

    Have inspected the P&P for the deadline for submitting a request for a Vote to Vote. It is commonly understood that it needs to be 4 weeks in advance (so says Juergen's emails prior to each meeting) but where is this requirement codified? Right now, the only place where the rules governing a Vote-to-Vote are described is in the Hitchhiker's Guide (V7.8) but that is not a normative document – just a guide. It really needs to be in the P&P.

  • Reported: ABPSC 3.3 — Fri, 18 Oct 2019 17:12 GMT
  • Updated: Fri, 18 Oct 2019 17:12 GMT

Clarification needed on Submitters, Supporters, and Contributors

  • Key: ABPSC-13
  • Status: open  
  • Source: Object Management Group ( Dr. Jason McC. Smith)
  • Summary:

    A recent discussion on the AB mailing list led to the following observations regarding Submitters, Supporters, and Contributors in OMG Submissions:

    1) Sanitized description of issue, from a non-public example
    Contributor was defined as a Participating Organization who is not a Submitter. Submitter is defined as OMG Member who provides an LOI. Participating Organization is defined as anyone who signs onto the agreement. Document states that all POs are bound to the IPR, at least in intent.

    PartOrg = IPRBound
    Submitter = OMGMember && LOI
    Contributor = !Submitter = !(OMGMember && LOI) = !OMGMember || !LOI

    Contributor => IPRBound && (!OMGMember || !LOI)

    So a Contributor could be either: not an OMG Member, or an OMG Member who didn’t file an LOI. Since not filing an LOI is supposed to be a non-starter for contributing, I assumed this was to include non-OMG Members in the process. (Additionally, if they’re not an OMG Member, then can they even file an LOI?)

    In all cases, a Contributor is bound by the IPR, which is intended for those contributing IP. All signs point to this being a back-door for IP-contributing non-OMG Members. Please correct me if I’m wrong. If wrong, then this entire thing gets easier, because....

    2) IPR Definition of ‘Contributor’ vs. ‘Member'
    Document: https://omg.org/cgi-bin/doc.cgi?ipr
    OMG Doc #: ipr/12-09-02

    IPR 1.2: "Certain OMG members who participate in the development of OMG Formal Specifications make commitments to license their IPR as set forth below.”

    --> This applies to OMG members only.

    This is supported by:

    IPR 8.1K: "“Obligated Party” means an OMG Member that has incurred a Contribution Obligation or a Participation Obligation. “Obligated Party” includes Affiliates of the OMG Member.”

    IPR 4.4A: "Obligated Parties. OMG Members are Obligated Parties only under the following circumstances:"

    However, in other places OMG membership is left completely out:

    IPR 2.1: "Each contributor of any material to an OMG Specification is [...]

    --> ‘contributor’ is never defined as exclusive to OMG members.

    IPR 3.2A: "Contributors. Anyone who makes a Submission or Contribution to an OMG Specification [...]

    IPR 8.1D: "“Contribution” means any written submission in response to an RFP or RFC, or to an FTF or RTF, that is intended to be included in an OMG Formal Specification. The variants “Contribute” and “Contributor” are subject to this definition."

    --> This is as close as it gets.

    The way it reads, non-Members can theoretically contribute, but only OMG Members can be bound to obligation under 4.4.

    The Document appears to extend this to non-members, but it isn’t precisely clear, and it would be sloppy to leave this to the legalese authoring skills of each team, don’t you think?

    Currently in the P&P (https://www.omg.org/cgi-bin/doc.cgi?pp/17-06-01)/ IPR:

    • Submitters are:
      • OMG members
        and
      • have previously submitted an LOI
        and
      • have contributed IP, and are bound by the IPR
    • Contributors are a somewhat defined entity of unclear OMG membership, but who are bound by the IPR, in theory
    • Supporters are an undefined non-entity

    Desired:

    • Submitters are:
      • OMG members, able to put forth a specification for voting
        and
      • have previously submitted an LOI
        and
      • have contributed IP, and are bound by the IPR
    • Contributors are:
      • NOT OMG members, not able to put forth a specification for voting
        and
      • have contributed IP, and are bound by the IPR
        and
      • MAY have previously submitted an LOI <--- This was unclear in the SysML2 Agreement. See 1) above
    • Supporters are defined as:
      • NOT having contributed IP, and therefore not involved in the IPR (or have formally withdrawn the IP)
        and
      • NOT submitted an LOI (or have withdrawn it via notification of intent to TechDir (P&P 3.7.2 and IPR 5))
        and
      • OMG status is irrelevant <--- Curious on thoughts here [1]

    As per IPR 5, once a Member contributes IP, they are bound to the Contribution Obligation. This is clear, but it is not clear what the outcome is for a non-Member Contributor, if such a thing is being allowed. Non-members cannot be on an Adoption Process Voting List (IPR 8.1B), but withdrawal from an Adoption Process Voting List is the single trigger for establishing the outcome of obligation with respect to IP in IPR 5.2. I see a loophole. The Document appears to pull in Contributors to this process, and I think that is the intent, but again, it’s not precisely clear.

    To get back to the original Submitter vs. Supporter (vs. Contributor) question:

    A Member signs on as Submitter, contributes IP, then lets their membership lapse. They’re no longer able to be listed as a Submitter, but they still need to be clearly bound by the IPR in the specification. Contributor would suffice here. If the Contribution Obligation is in effect, then the organization should be listed as Submitter or Contributor, based on OMG Membership.

    An organization can drop to a theoretical Supporter status only if clause 5.2C is met, neither Contribution nor Participation Obligations.

    I think that having this be clear would be an improvement. Supporters should be, IMO, bystanders who support the effort but who did not contribute to the creation of the document in a way that would worry their internal legal staff.

    [1]
    Allowing non-OMG Members to sign on as Supporters at will is a nice gesture, but requiring membership to do so could help drive, well, Memberships. One for the BoD, I think.

    Larry had the following comment:

    There is no such thing as a supporter in P&P. Supporters are cultural artifacts and have no standing. There are only submitters... however; under IPR (see Jason's [comments]), submitters are responsible for the IPR claims on material in the submission, hence stuff rolls downhill should someone else contribute... and note there is no requirement that contributors be declared (as are the Supporters with no standing) unless there is an issue/condition to be declared under the IPR agreement.

  • Reported: ABPSC 3.3 — Wed, 16 Oct 2019 19:16 GMT
  • Updated: Wed, 16 Oct 2019 19:16 GMT

Need a new process - Request for Curation Inclusion (RFCI) Process

  • Key: ABPSC-7
  • Status: open  
  • Source: Lockheed Martin ( Mrs. Laura E. Hart)
  • Summary:

    Request that a new Request for Curation Inclusion (RFCI) process template and associated document template be created to support the review and vetting of reusable content that is considered valuable to our OMG communitiy. Examples of content include FIBO updates, CubeSat Reference Model (CSRM), other domain model examples, libraries, and methods. Our current RFP process ab-18-12-10 RFP, is not appropriate for non-language content but could be tailored and streamlined to support the review, approval, maintenance and archival of content that is generated using OMG specifications (OMG UML, SysML, UAF, BPM....).

    Curation: 1. The action or process of selecting, organizing, and looking after the items in the collection.. 2. The selection, organization, and presentation of online content, merchandise, information etc., typically using professional or expert knowledge.

  • Reported: ABPSC 3.3 — Mon, 8 Apr 2019 14:05 GMT
  • Updated: Mon, 8 Apr 2019 16:50 GMT