Software Release Procedure
These are the updates and announcements that need to be posted whenever a new version of any of the iHRIS software is released and the locations of important documents.
NOTE: All electronic Toolkit updates will also need to include an additional update to the Toolkit ZIP file, which is used for burning on software and flash drives. The latest ZIP is always located here: http://www.capacityproject.org/hris/hris-toolkit/hris-toolkit.zip NEED TO UPDATE ZIP FILE
User's Manuals (Help)
During testing, update the Help File Originals with any procedures that have changed and new features. Update screenshots of changed screens as well. NOTE: Help documentation for iHRIS Plan and Qualify need to be updated, and screenshots need to be added.
Create a book for each user's manual on the wiki. The iHRIS Manage User's Manual and iHRIS Qualify User's Manual has already been created, but will need to be updated if any pages are removed or added. NOTE: A book for iHRIS Plan will need to be generated.
Generate a new HTML version of the user's manual to include with the software (Luke). Generate a PDF to include in the electronic Toolkit. Upload the PDFs to this location: http://www.capacityproject.org/hris/hris-toolkit/tools/pdf/. See the Software Documentation page for individual filenames (all website links point here). Also add copies to the electronic Toolkit ZIP file.
NOTE: If there have been any changes to the Data Dictionary, you will also need to generate that file as a PDF and upload to the electronic Toolkit in the same locations as the user's manuals.
Bug Reports
Review all bugs reported in Launchpad. Mark bugs that have been fixed or are in progress.
Use Cases
Update all use cases with changes, resolved issues or new issues. Write new use cases or requirements, if needed to document new features. The original use case files are located on SharePoint in the iHRIS Software Suite Document Library. You will need CaseComplete to update the files.
NOTE: There are 4 use case files: one for each of the software programs, and one for use cases that are common to all of the programs in the suite. If you open multiple use case files in CaseComplete, you can print them to the same report.
If there have been changes, generate a new HTML report for each software program: Manage, Qualify and Plan. Be sure to include the shared (Common) use cases in each of these reports. Upload these to the website at this location: http://www.capacityproject.org/hris/suite/. See each software page for individual filenames.
Also generate a new Word report separately for each software program: Common, Manage, Qualify and Plan. I generally edit the Word reports to remove use cases that have not yet been implemented and open issues, so as to prevent confusion. Upload the DOCs to this location: http://www.capacityproject.org/hris/hris-toolkit/tools/doc/. See the Software Documentation page for individual filenames. Also add copies to the electronic Toolkit ZIP file.
Release Notes
Update the release notes with the latest version number, release date, new features/bug fixes in the release and known issues with the release.
- README File for iHRIS -- Manage and Qualify
- README File for iHRIS Plan -- Plan
- Release Notes for Windows iHRIS
Save each new release file as a README file in TXT format. Upload the README file to the download pages on Launchpad for each release.
Features Lists and Roadmaps
For each software release, update the features lists and roadmaps on the website. The features list should be updated with the latest version number, all features available in the latest version, all planned features scheduled for development and all requested features not yet scheduled. The roadmaps should be updated with the date and location of the latest release and the timeline for planned releases.
- iHRIS Qualify Features and Roadmap
- iHRIS Manage Features and Roadmap
- iHRIS Plan Features and Roadmap
The Development Team should also update the Development Timelines on the wiki.
Download Links
Once the software is posted to Launchpad, update the download links and version numbers on the Software Downloads page on the website. Luke will provide the links.
If there is a new Windows version, it will need to be added to the electronic Toolkit. Upload the EXE file here: http://www.capacityproject.org/hris/hris-toolkit/tools/exe/ and add it to the Toolkit ZIP. Be sure to change the link on the Toolkit iHRIS Software Suite page to reflect the change in version number.
Announcements
An announcement of the new release version including the location of the download and demo, and a summary of any new features should be posted in all of the following places:
- HRIS Strengthening Blog
- Launchpad Announcements
- ihris-announce Mailing List
- ihris-developers Mailing List
- HRIS team mailing list
- iHRIS.org blog
- News article on CapacityPlus site/IntraHealth site
- iHRIS Twitter account (encourage retweets by CapacityPlus, IntraHealth, IntraHealth Open, etc.)
Be sure to link to the release notes in the announcement.