Derby
  1. Derby
  2. DERBY-2570

Create a utility which generates Release Notes

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 10.3.1.4
    • Fix Version/s: 10.3.1.4
    • Component/s: Build tools
    • Labels:
      None

      Description

      This proposal summarizes an off-list conversation among Myrna van Lunteren, Bernt Johnsen, Andrew McIntyre, and myself.

      Currently, there is a template for release notes in the top level directory of the code tree. Actually filling in this template is a time-consuming, error-prone process. We would like to automate this process as much as possible. We believe it ought to be possible to generate the Release Notes given the following inputs:

      1) A high-level description of the release. The Release Manager would write this description, based on a template.

      2) An xml report produced by a JIRA filter. The filter would list all of the JIRAs addressed by the release.

      In order for this to work, we would need for the community to agree on conventions for the release notes which are attached to JIRAs, viz., the JIRAs whose "Release Note Needed" toggles are turned on. These JIRA-specific notes become items in the Issues section of the final Release Notes. Each of these items calls the reader's attention to a significant topic involving Derby's behavior, that behavior's compatibility with previous releases, and adjustments which the user may need to make to her applications.

      The following approach makes sense to us:

      A) The community will agree on an html template for these notes.

      B) The note-writer will fill in this template and attach it to the JIRA using a canonical file name, say "releaseNote.html".

      C) Various iterations of the note may be needed.

      D) The utility for generating Release Notes will grab the latest rev of "releaseNote.html" attached to the JIRA.

      This effort involves at least two major steps:

      I) Getting the community to agree to these note-writing conventions.

      II) Writing the Release Note generator.

      1. DERBY-2570_20070525.diff
        11 kB
        Myrna van Lunteren
      2. derby-2570-v01.diff
        110 kB
        Rick Hillegas
      3. derby-2570-v02.diff
        2 kB
        Rick Hillegas
      4. derby-2570-v03.diff
        6 kB
        Rick Hillegas
      5. derby-2570-v04.diff
        13 kB
        Rick Hillegas
      6. derby-2570-v05.diff
        3 kB
        Rick Hillegas
      7. derby-2570-v06.diff
        7 kB
        Rick Hillegas
      8. releaseNote.html
        2 kB
        Rick Hillegas
      9. releaseNote.html
        2 kB
        Rick Hillegas
      10. releaseSummaryTemplate.xml
        3 kB
        Rick Hillegas

        Activity

        Rick Hillegas created issue -
        Rick Hillegas made changes -
        Field Original Value New Value
        Attachment releaseNote.html [ 12356089 ]
        Rick Hillegas made changes -
        Attachment releaseNote.html [ 12356156 ]
        Rick Hillegas made changes -
        Assignee Rick Hillegas [ rhillegas ]
        Rick Hillegas made changes -
        Attachment releaseSummaryTemplate.xml [ 12357276 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v01.diff [ 12357404 ]
        Rick Hillegas made changes -
        Derby Info [Patch Available]
        Myrna van Lunteren made changes -
        Attachment DERBY-2570_20070525.diff [ 12358290 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v02.diff [ 12359941 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v03.diff [ 12359942 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v04.diff [ 12359943 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v05.diff [ 12360056 ]
        Rick Hillegas made changes -
        Attachment derby-2570-v06.diff [ 12360123 ]
        Rick Hillegas made changes -
        Resolution Fixed [ 1 ]
        Status Open [ 1 ] Closed [ 6 ]
        Myrna van Lunteren made changes -
        Resolution Fixed [ 1 ]
        Status Closed [ 6 ] Reopened [ 4 ]
        Myrna van Lunteren made changes -
        Derby Info [Patch Available]
        Fix Version/s 10.3.0.0 [ 12310800 ]
        Status Reopened [ 4 ] Closed [ 6 ]
        Resolution Fixed [ 1 ]
        Gavin made changes -
        Workflow jira [ 12402310 ] Default workflow, editable Closed status [ 12800661 ]

          People

          • Assignee:
            Rick Hillegas
            Reporter:
            Rick Hillegas
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development