About this page: Outlines current release notes layout.
Release notes provide FOLIO libraries and hosting providers important details about a release. It allows libraries and hosting providers to prepare for migrations to FOLIO and upgrades from one release to another. Release notes provide:
- Migration instructions and details
- Release upgrade instructions and details
- Known issues
- Permissions (new and deprecated)
- Highlight new apps and/or major features
- Release presentations
Random thoughts: Imagine being asked to put a jigsaw puzzle together without all the pieces. Well incomplete release notes mean that folks do not have all the pieces for a release. Or think of your team's release dev as a gift; the release notes is the bow that makes the gift complete. You see what I am getting at....
Who is responsible for updating release notes? PO/Team development lead/Solution Architect are responsible for updating release notes.
Release notes are critical and should be added as soon as possible so that libraries and hosting providers have as much time as possible to review notes and prepare. Starting with Poppy, release notes deadlines have been added to release timeline. Poppy final release notes deadline is October 13 2023.
Current release notes layout
Section 1: Notes on functionality > PO release presentations
- Product owner post any PO Release Presentations
- Product owner must include links to any slide decks and recordings
Section 2: Important Upgrade Considerations > Changes and Required Actions
- This section outlines all changes that require special consideration for customers in production. Configuration changes may be needed to prevent operational interruptions. See checklist for guidelines on how to fill this out.
- PO and/or Dev lead must complete this section and should include any critical changes and or required migration/upgrade actions for hosting providers.
Section 3: Important Upgrade Considerations > New apps
- Please post high level details regarding any new app. Include a link to any presentation or documentation that you think would be helpful.
Section 4: Important Upgrade Considerations > Removed apps
- Please list the removed app with a brief explanation for why it has been removed.
Section 5: Important Upgrade Considerations > Permission updates table
- Post details regarding new/deprecated permissions
Section 6: Known issue
Section 7: Notes on functionality tbale
POs should
- Update release notes once a feature and/or issue is set to PO Review.
- Ask SM to coordinate time for devs to add release notes throughout the release
- If no SM, PO should remind devs to add release notes throughout the release
- Add a label to track known issues for a release
- Add a label for features/issues that require a release note
- Beware of any updates/migrations that may result in significant service disruption or results in significant changes to data (i.e. MARC - FOLIO mapping rules changes)
- Please remember to update release notes if required for a Critical service patch (CSP)