Before completing this checklist and reviewing it with your sponsoring workgroup, these steps will to help you get through the process:
https://hl7.org/permalink/?CDAStyleSheet When using the CDA_SDTC schema, use this link address for the extension schema: https://github.com/HL7/cda-core-2.0/tree/master/schema/extensions/SDTC
After obtaining approval from your sponsoring workgroup, please send an e-mail to cmg_inbox@hl7.org <cmg_Inbox@HL7.org> with the following information:
|
Step 1. | IG Content: Documented Open Issues | |||
Confirm that any JIRA trackers that have addressed in this version of the IG have been marked with the "Implemented in version" field in JIRA. (Note: to complete this step, the new version of the specification needs to be added within JIRA. Read more about how to configure Specification Feedback. Confirm that any Open Issues present at the end of Ballot Reconciliation are documented in the relevant JIRA trackers with a note on planned release. In some cases this may be 'future' without a set date. Implementer notes, such as FHIR "dragons be here", may be included within an IG when appropriate. Do not documented open issues on the Confluence page associated with the project. Open issues should be addressed only as open JIRA trackers or as Implementer Notes within the IG. | ||||
| Initials: GC | Date: 2023-03-20 | Notes added version 1.2.0 and the list of artefacts to HL7/JIRA-Spec-Artifacts. Updates already active in Jira. | |
Step 2. | Cover page, footer and TOC Information < ---- Future Update Will Be Needed based on new Guidance in the GOM on Specification Name | |||
Confirm the specification files (Volume 1, Volume 2 or could be a single file that has both volume 1 and volume 2 content in it) word documents contain no tracked changes or comments. Confirm the Cover Page and footer version number aligns with the version that is used in Jira to log comments. (It is used in the field called "Raised in version" which is documented in the HL7 essentials area of Confluence: https://confluence.hl7.org/pages/viewpage.action?pageId=19136736#SpecificationFeedback-RaisedinVersion) Example Cover Page information: Specification Date: August 2015 Specification Name: HL7 CDA R2 Implementation Guide: Consolidated CDA Templates for Clinical Notes (C-CDA) Specification Version: 2.1.0.7 August 2022 Example Footer: 2.1.0.7 August 2022 Confirm the TOC(s) have no visual errors and the links are working. | ||||
| Initials: GC | Date: 2023-03-20 | Notes: There are no word documents Generated PDF in https://github.com/HL7/CDA-pharma/tree/main/input/pdf Added the Spec. Version and Updated the Footer. | |
Step 3. | Use Case Review | |||
Confirm that the specification includes at least one clearly enumerated Use Case that illustrate the expected uses for the implementation guidance. | ||||
| Initials: GC | Date: 2023-03-20 | Notes | |
Step 4. | Code System and Value Set Review < ---- Proposed Update on 10/24 for Review | |||
For each code system used in the IG or used by value sets referenced in the IG:
For each value set referenced in the IG, confirm that:
Confirm all value set bindings:
Confirm No Terminology Related Errors in IG Publishing Tool. | ||||
| Initials: GC | Date: 2023-03-20 | Notes There are no links in the pdf for the value sets (links are active in the web available version; links are resolvable and satisfy the requirements. No STATIC bindings All checked value bindings have a binding stability (this is added by default by the tool) | |
Step 5. | Sample File and Schema Review | |||
For each sample file:
| ||||
Below, list the included sample files included with descriptions: No CDA samples provided, because no document level templates are defined by this IG. This exception was agreed for the previous STU 1 release. | ||||
| Initials: GC | Date: 2023-03-20 | Notes to document any validation errors present. This IG doesn't define any document level template, so no document level samples are provided, nor external fragment examples. In line fragment examples are validated by the editing tool (ART-DECOR) | |
Step 6. | Github Repository Review | |||
Confirm that a Github repository has been established for the Specification. Confirm that the content associated with this version of the Specification has been loaded into the Github repository following best practice guidelines listed as instructions below. CDA Artifact Github repo management guidance: https://confluence.hl7.org/display/SD/CDA+Github+Repository+Best+Practices | ||||
Item reviewed: | Paste link to github repo https://github.com/HL7/CDA-pharma | |||
| Initials: GC | Date: 2023-03-20 | Notes | |
Step 7. | _Readme.txt Package File Review | |||
Confirm the _Readme.txt file and content meets the requirements of the template included by reference below. These are the correct permalinks to be used when explaining where the CDA stylesheet and CDA schema's are located (Only a pointer to these materials can be included in the download package published on the HL7.org standards grid.): https://hl7.org/permalink/?CDAStyleSheet When using the CDA_SDTC schema, use this link address for the extension schema: https://github.com/HL7/cda-core-2.0/tree/master/schema/extensions/SDTC When using specialized stylesheets, include the specialized stylesheets or a link to the location of the specialized stylesheets within the Github repository. Check the _Readme.txt file for accuracy:
Link to _Readme.txt template (template includes text to be updated): _Readme.txt Template | ||||
| Initials: GC | Date: 2023-03-20 | Notes _Readme.txt to be updated with the Publication date when this will be available | |
Step 8. | Publication Request Form Review | |||
Confirm the Publication Request is populated correctly:
| ||||
| Initials: GC | Date: 2023-03-20 | Notes Publication Request in HL7 CDA Pharmacy Template STU2 checked and https://www.hl7.org/special/Committees/tsc/ballotmanagement/pi_index_nibs.cfm?ProjectNumber=1139 | |
Step 9. | Publication Request quality attestation | |||
Sponsoring WG Co-chair or technical resource from Sponsoring WG attests to having completed all required QA checklist steps and attests to the Implementation Guide and its publication package as meeting all requirements checked during the Publication Request QA review. NOTE: After a Publication Request has been fully approved, the specification author is responsible for updates to support Configuring Specification Feedback. ALSO NOTE: Configuring Specification Feedback updates also must be made prior to a specification going to ballot. When a ballot version of a specification completes reconciliation and all comments have been resolved and the specification is approved to be published, the ballot version of the specification needs to be deprecated in JIRA and the newly published version needs to be added with deprecation=false. The default specification version also needs to updated. | ||||
By checking complete below, confirm that the following language appears in the Sponsoring WG's motion for approval: "Based on this WG's review of the CDA Publication Checklist for this IG (insert link here to the completed Publication Request Checklist for the IG) and confirmation that no quality variations have been detected during the performed review, a motion has been made to approve the CDA IG Publication Request." Link to minutes of approving workgroup: | ||||
| Initials: GC & JD | Date: 2023-03-20 | Notes: Sent email to GC to add link in checklist. |
--------------------------------------------------Steps to complete the vote CMG ONLY -------------------------------------------------
Step 10. | Enter Request in Approval Log | |||
Confirm the Publication Request and Candidate Publication Package has been checked-in on the CMG Document Approval Page. (CMG Approvals Log - Current Year) | ||||
| Initials JD | Date 4/4/2023 | Notes | |
Step 11. | Perform CMG Review of Publication Request Checklist | |||
Confirm the link to the Publication Request Quality Checklist in the CMG Document Approval Page works. Confirm that all the steps have been marked completed and that there are no significant issues identified. Confirm the link to the Sponsoring WG's Minutes showing their attestation of the information contained in the Publication Request Checklist. If the Specification Package and Publication Request passed Work Group inspection, proceed to initiate the vote in CMG. If is does not, send the request submitter information about the issue that the QA check revealed and explain how to resolve the problem. | ||||
| Initials JD | Date | Notes
| |
Step 12. | Conduct Votezip file | |||
Follow steps for in-person or e-Voting to approve the request. Note: CMG instructions on how to conduct e-Voting are documented here. Record the results of the vote in the CMG meeting minutes. Note: if the eVote completed you can proceed to Step 13 to accelerate completion of a Publication Request, then go back and record the outcome of the eVote in the CMG meeting minutes at the next CMG meeting. | ||||
| Initials JD Contingent on the following six things to be resolved:
| Date 4/5/2023 | Notes GC
JD Reviewed (looks good) | |
Step 13. | Complete Approval Documentation | |||
Link to vote: 2023-04-05 CMG Meeting Notes If the vote passes to approve the publication request:
If the vote does not pass:
| ||||
| Initials JD | Date | ||
Step 14. | Send Approval information to TSC | |||
After documenting an approved Publication Request:
| ||||
| Initials JD | Date | Notes |