AEP 1.0 FTF Avatar
  1. OMG Issue

AEP — Relationship between Section 6 & 7 unclear

  • Key: AEP-13
  • Status: closed  
  • Source: Object Management Group ( Andrew Watson)
  • Summary:

    The relationship between sections 6 & 7 isn't clear. Are they two alternative descriptions of the same thing? Or two specifications of two different things? Please clarify.

    The whole of section 6 is a natural language specification of a complex calculation to be undertaken to compute an Automated Enhancement Points value for a program. If this isn't specified formally elsewhere (e.g. using SMM & OCL or ALF, then it should be).

    On the other hand, if (as I suspect) section 7 is the formal specification in SMM of the algorithm informally described in Section 6, then more description is needed of how the two relate to each other.

    Section 7 also needs to be made more human-readable. This human reader couldn't extract any meaning at all from PDF pages 35 to 147 (although I'm sure there's plenty of meaning there!). If this is just a formatted dump of the contents of admtf/15-10-02 (the XMI file), then including it doesn't add much value to the specification. It's only worth including if it can be related to the contents of Section 6 and/or it includes extra explanatory text to help implementers understand the XMI file.

  • Reported: AEP 1.0b1 — Wed, 6 Apr 2016 07:38 GMT
  • Disposition: Resolved — AEP 1.0
  • Disposition Summary:

    relationship between clauses 6 & 7 clarified

    Discarding §7 and beefing up §6•beefing up §6 is two-fold: more details in plain text and inclusion of references to XMI content, from discarded §7, in framed boxes
    Alignment of §6 on normative content as requested by AEP-14 , including references from XMI content in text boxes

  • Updated: Tue, 11 Oct 2016 14:46 GMT