1. OMG Issue

UPDM — element descriptions

  • Key: UPDM-752
  • Legacy Issue Number: 13612
  • Status: closed  
  • Source: 88solutions ( Manfred Koethe)
  • Summary:

    Summary Throughout all element descriptions: Apparently a lot of text was generated (either by machine or cut-and-paste). However, one size does not fit all! The lead-in text of "Extensions" suggests the wrong (opposite) direction of extension. The current text reads for exmple "The following are extensions for MilestoneSequence:" but should read "The following metaclasses are extended by MilestoneSequence:" This needs to be corrected for all element descriptions in Part II.Similar, the lead-in text for Generalizations is not strictly wrong, but certainly sub-optimal. The current text is rather useless since it doesn't give a clue what is the general and what the specialized element. Maybe some text like: "The following elements are specialized by xyz:" is more adequate.Page 21, Performs: The constraints "RealizesCapability.supplier" and "RealizesCapability.client" are not shown in the diagram.In general, Part II suffers from several formatting flaws (due to its generated nature?):Lines like "Generalizations", etc., stand much more out than section headers.Discriminators like "MODAF:" are flowing into the next word without space. For example on Page 24, EnvironmentProperty: "MODAF:Asserts that...", should be "MODAF: Asserts that..." Some lines are stretched almost beyond readability.In many constraint descriptions, the initial character of the role name is wrongly capitalized.
    Diagram GeneralDocumentationIssues for Part 2
    Document Issue UPDM (OMG Beta) Jan 2009

    Source Manfred Koethe

  • Reported: UPDM 1.0b1 — Fri, 27 Feb 2009 05:00 GMT
  • Disposition: Resolved — UPDM 1.0.1
  • Disposition Summary:

    Changes will be made to the template that is used to produce the document so that the text regarding extensions will be changed from
    The following are extensions for ElementX :
    The following metaclasses are extended by

    A similar approach will be taken with generalizations where they currently read.
    The following are generalization relationships for Element X:
    This will be changed to
    The ElementYZ is a specialization of elements:
    The heading section will change from Generalizations to Specialisations

  • Updated: Fri, 6 Mar 2015 22:56 GMT