XMLWordPrintableJSON

    Details

    • Type: Task
    • Status: Resolved
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 1.8.0
    • Fix Version/s: 1.7.3, 1.8.1, 2.0.0
    • Component/s: docs
    • Labels:
      None

      Description

      UPGRADING.md was not updated for the 1.8.0 release. I actually didn't even realize we were putting notes about specific upgrade paths in a per-release way inside our release.

      This is prone to being overlooked and forgotten. We should have generic version-agnostic information in UPGRADING.md, and put more specific per-release notes in an UPGRADING section on the release notes for specific upgrade issues. At the very least, the version of this document for the current release does not need to contain upgrade instructions for upgrading to previous releases.

      The more information we have in our documentation which is written to correspond to the current/next release, the more (undocumented) manual steps are involved for a release manager, and the more likely these steps are going to get overlooked and forgotten.

        Attachments

        1. UPGRADING.md
          7 kB
          Michael Wall

          Issue Links

            Activity

              People

              • Assignee:
                mjwall Michael Wall
                Reporter:
                ctubbsii Christopher Tubbs
              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:

                  Time Tracking

                  Estimated:
                  Original Estimate - Not Specified
                  Not Specified
                  Remaining:
                  Remaining Estimate - 0h
                  0h
                  Logged:
                  Time Spent - 2h 10m
                  2h 10m