Checklist
Pre-Release
Start release planning immediately after each release according to the section Post-Release below - maybe there is actually not pre-release phase - to be verified
Freeze Phase
- Create the release on the QA server
- Inform developer of the freeze
- Create the release branches
- Define the version of the modules based on semantic versioning
- Check the Continuous Integration in details
- Publish the release branch on PyPi and NPM (required to check the packaging)
- Inform the integrator about the UAT timeline (Beta version)
- Add user account on the QA server
Alpha Phase
- create release instance using the released modules
- perform some basic testing
- Claim: create/review/process
- Registration: create/update familly/insuree
- Enrollment: create policy and contribution
- Meta data: create/update location/product/user/role/pricelist/itemslist/servicelist
- Make sure defects are assigned to developpers
Beta Phase
- Update the PyPi, NPM module when code change was done
- Check that the release instance use the latest modules
RC Phase
- Update the PyPi, NPM module when code change was done
- Check that the release instance use the latest modules
- Start collecting the documentation from developers
GA Phase
- All affected repositories (GitHub, Pypi.org, http://npmjs.com , etc.) are tagged and versioned according to Version management
- Update the
openimis.json
to use only official version (not rc) on assembly modules - Merge release branches with main
- Update demo server
- Formulate release notes in current release (Releases) and forward it to co-ordination desk for promotion (e.g. newsletter, Twitter)
Post-Release
Start preparing the next release immediately after the current release.
- Create the release page (e.g. Release 2022-04) for the following release and make sure it appears correctly on Releases
- Define milestones according to the framework in Releases
- Create the relevant epics for the new release (e.g. Release 2022-10) in Jira and add them to the release page
- Create a clean Release Checklist for the next release (e.g. Release 2022-10)
Following need to be integrated
Releases Page Releases
- Analyze linked issues as a normal user (private projects hidden)
- All links are working and are helpful
- Dates and status of all releases are correct
Release Page
e.g. Release 2022-04
- All links are working and are helpful
- Release is marked as “GA” and dates are correct
- All relevant tickets are assigned
- All assigned tickets are marked “Done” or pushed to the next release
- Epics align with the “Highlights” of the release
- Points to the correct “Release Sources Page” under “Downloads” e.g. Sources Release 2022-04 for Release 2022-04
Release Sources Page
- All components are consistently versioned according to Version management
- All links are working and helpful
- All components link to the correct repository and version
- All components have correct “Release Notes”
- All components link to reasonably similiar named repositories / package manager
Release Notes
- Every effected component in the release specific sources page (e.g. Sources Release 2022-04) has an updated and complete change log in it’s repository
User Documentation
- User Documentation is up-to-date http://docs.openimis.org/en/latest/ / http://docs.openimis.org/fr/latest/
Installation Guide / Configuration / Other
- Installation guide / Installation and Country Localisation supports installation of the latest release
- Developer Starter Kit reflects latest release
- “Technical Requirements” / Connectivity & theoretical infrastructure required reflects lastest release
- Tutorials on YouTube are up-to-date / not misleading
Sandbox Landscape Sandbox Landscape
- Demo: openIMIS Instance and Wiki page are up to date
- Release: openIMIS Instance and Wiki page are up to date
- Sandbox Landscape Other instances are up to date / compatible with Demo: openIMIS / Release: openIMIS
Findings Release 2022-04
- Release 2022-04List of assigned tickets seems to be incomplete (Huge changelog for Legacy Web App, but empty list of tickets!?)
- Release 2022-04 Some assigned tickets are not “Done”
- Sources Release 2022-04 Double entry of repository https://github.com/openimis/openimis-fe-tools_js“FE French Translations” and “FE Tools”
- Sources Release 2022-04 Link to package manager of “FE French Translation” is broken
- Sources Release 2022-04 “FE French Translations” - Mismatch between name of module and name of repository / Mismatch between “Version” and “Repository” (wrong repo “openimis-fe-tools.js” ?)
- Sources Release 2022-04 Some links to installation guides under “Legacy” and “Deprecated” are broken
- Sources Release 2022-04 Link to ”Backend installation guide” is broken
- Sources Release 2022-04 Link to “Frontend installation guide” is missing
- Release 2022-04 Status is not “GA”
- Releases Status of Release 2022-04 is not “GA”
- Release 2022-04 Link to “Release Notes” is broken
- Sources Release 2022-04 Chapter General/Intro: Most links are broken or not helpful
- Sources Release 2022-04 Chapter “Database”: Link “Installation guide” is broken
- Sources Release 2022-04 Chapter “Docker scripts”: Links for “Installation guide” are broken
- Sources Release 2022-04 Some version numbers have 4 digits, others 3
- Sources Release 2022-04 Some version numbers have “rc..”, “April” and so on in their names
- Sources Release 2022-04 “Installation guide” links in “openIMIS modular version - Docker scripts” are broken
- Sources Release 2022-04 Double “BE Claim AI”
- Sources Release 2022-04 “FE French Translations” - Missing “Release Notes”
- Sources Release 2022-04 “FE Claim Batch” - Missing “Release Notes”
- Sources Release 2022-04 Most (all?) dependency links are broke
- Sources Release 2022-04 Some components don’t link to the “latest” on GitHub (e.g. Claims mobile application)
- https://openimis.atlassian.net/wiki/spaces/OP/pages/368345128 Warns about an old release → Release 2021-04
- https://openimis.atlassian.net/wiki/spaces/OP/pages/368345128 Is inconsistent and messy
- Sources Release 2022-04 Does not link to the latest version according to https://openimis.atlassian.net/wiki/spaces/OP/pages/1277296705 and GitHub
- Sources Release 2022-04 “BE Calcrule Contribution Legacy” does not link to a version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/3299966977 does not link to a version
- Sources Release 2022-04 “BE Calcrule Capitation Payment” does not link to a version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/3300229121 does not link to a version
- Sources Release 2022-04 “BE Tools” does not link to a version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/3300229121 does not link to a version
- Sources Release 2022-04 “Frontend assembly” points to an old version
- Sources Release 2022-04 “FE French Translations” points to an old version but names a new version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/1277624413 Is not up2date
- Sources Release 2022-04 “FE Claim Batch” points to an old version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/814448725 is not up2date
- Sources Release 2022-04 “Policies mobile application” points to an old version
- Sources Release 2022-04 “Claims mobile application” points to an old version
- https://openimis.atlassian.net/wiki/spaces/OP/pages/814055471 is not up2date
- Sources Release 2022-04 All BE components point to http://pypi.org except “Backend assembly”, “BE Calcrule Contribution Legacy”, “BE Calcrule Capitation Payment“, “BE Tools”
- Sources Release 2022-04 Duplicate entry of “Backend Assembly” and “Frontend Assembly” under “Docker file scripts”
- Links in Version are not pointing to the release notes
- Repository-Link should not point to a specific version
- Sources Release 2022-04 “Docker script for gateway” does not contain links to Version or Repository
- Sources Release 2022-04 Links to Repository should have a consistent format
- Sources Release 2022-04 “Docker-compose script” states dependency to legacy “openIMIS Web Application”, that shouldn’t be the case anymore with the new release