OCL 2.3 RTF Avatar
  1. OMG Issue

OCL23 — OCL 2.0 Inadequate Headings and PDF index

  • Key: OCL23-7
  • Legacy Issue Number: 14200
  • Status: closed  
  • Source: Model Driven Solutions ( Dr. Edward Willink)
  • Summary:

    The OCL 2.0 specification would be much easier to read if:

    1) The PDF had a full set of titles visible in the bookmarks:

    8.3.*, Annex A.2 , Annex B and Index are missing completely.

    A.1 and A.3 apppear as subsections of 13.3.

    2) There are a number of large sections such as 8.3.*, 9.3 and 10.4 with unnumbered headings for each AS or CS class.
    [11.5 is much better in this respect.]

    These are not in alphabetical order, not page aligned and not particularly distinct.

    It would be helpful to

    a) give them numbers so that they appear in the Bookmarks and are more distinct.
    b) put them in alphabetical order.
    [c) consider page aligning them.]

    [It would be good if the index was much more comprehensive too.

    e.g "at", "null", "any", "iterator", "UnlimitedNatural" ...]

  • Reported: OCL 2.1 — Sat, 22 Aug 2009 04:00 GMT
  • Disposition: Resolved — OCL 2.3
  • Disposition Summary:

    PDF bookmarks were fixed in OCL 2.3.
    Alphabeticizing must wait until autogenerated in OCL 2.5.
    Provision of a manually maintained index in OMG specifications is strongly discouraged.
    Disposition: Closed, no change

  • Updated: Fri, 6 Mar 2015 20:58 GMT