PCC Profile Deprecation Process
Deprecation is a multi-step process leveraging two statuses: Intent to Deprecate and Deprecated. First, an assessment is performed on the Profile in question and communication is sent out to the community about the intent to discourage use of this profile. At this point (or shortly thereafter) the profile enters Intent to Deprecate status. After a period of at least 18 months the Profile is then officially deprecated as indicated by the steps below. This time period may be adjusted based on appropriate rationale. The reason that we choose to execute this in a multi-step, multi-state (i.e., "Intent to Deprecate," "Deprecated") approach is to provide transparency to the community. All information gathered as part of the deprecation process will be recorded on one or more wiki pages for maximum transparency and ease of access by the community.
- The retiring of an IHE Profile with supporting rationale
- That IHE will no longer provide updates to or support for the Profile (e.g., CPs will by default not be processed by the committee for Profiles in the intent to deprecate status)
- Complete when the process outlined on this page is followed
Deprecation is not/does not:
- Prevent implementers from continuing to use the Profile
Following are a list of questions to ask, and required actions to take.
Checklist for Assignee for Deprecation
- Answer the questions found in the Evaluation of Published of Profiles
- What is the rationale behind deprecating the Profile?
- Provide specifics as to the need to remove the Profile from publication and for IHE to no longer provide support
- What are the adoption levels of the profile to be deprecated?
- Review Connectathon Test Results page
- Review IHE Product Registry database
- Survey implementers to confirm actual usage in pilot and/or production settings.
- Work with IHE Regional Deployment Domains
- Is the profile being deprecated being replaced by a new profile?
- If yes, which profile, and what actors, transactions, options, etc. are being used in the new profile?
- What dependencies exist for the Profile being deprecated?
- Are there any required Profile Groupings?
- Are there any dependencies TO other IHE Profiles?
- Are there any dependencies FROM other IHE Profiles?
- Who needs to be notified about deprecating the profile?
- Required groups to be notified: development domain (e.g., PCC), Domain Coordination Committee (DCC).
- Additional groups to be notified: implementers, stakeholders, other IHE Development Domains, IHE Deployment Domains, government organizations
- How long does the Profile remain published in intent to deprecate status?
- The default time period is 18 months
- If a longer or shorter time period is desired, rationale must be provided
Checklist for Committee Technical Cochair
- Ensure the above questions are answered
- Update the wiki to reflect status as Deprecated
- Coordinated and/or send communications - work with Sponsor if appropriate
- Update/remove any OID Registry and Template ID entries
- Work with IHE Documentation Specialist (Mary Jungers) for any additional documentation management tasks
- Remove applicable profiles from ihe.net here
- Remove the link but keep the name; add a note that the supplements are in intent to deprecate status
- Update the ihe.net archive page here
- Remove applicable profiles from the current published folder on the ftp site
- When applicable, update Appendix A to indicate the deprecated actors
- When applicable, update Appendix B to indicate the deprecated transactions
- Update Inventory of Profiles in Google Sheet here
- Add indicator of date to change status from Intent to Deprecate to Deprecated in the appropriate place
- Remove applicable profiles from ihe.net here
Questions, Discussion, and Next Steps
- Where should answers to the above questions be documented? On the wiki? In a Google document? Elsewhere?
- Create a wiki page to track deprecated Profiles in PCC. This page should link to an additional page with information from the answered questions above for each deprecated Profile.
- When Profiles enter Deprecated status (after Intent to Deprecate status is complete) where do those profiles go?
- This is a conversation that needs to happen through a broader group than PCC, involving DCC and the Documentation Management team
- How does IHE Documentation Management desire to show "Intent to Deprecate" vs "Deprecated" status on ihe.net and other relevant locations?
- ITI Experience
- Not everyone using profiles show up to Connectathons, need a good way to ask if there are any users
- PCC consulted with QRPH on their Profile deprecation experience, and is certainly open to input from other domains that have dealt with deprecation.