Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

  •  Complete

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.

  •  Complete

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. 

  •  Complete

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:

      1. Confirm any code system used in the IG which is not an example code system, is listed in Terminology.HL7.org (THO) and if it is an external code systems, then it is listed on the External Code Systems tab and that the Code System is identified in the IG as indicated in THO.  If a code system used in the IG is not present in THO, go to the TSMG Confluence Page titled "Terminology Expectations for IG Developers" and follow the provided guidance to correct this problem before seeking to publish the IG. 

For each value set referenced in the IG, confirm that:

      1. the value set has a link that takes you to the Source value set definition
      2. the name of the source value set the same as the name used in the IG
      3. the identifier (OID) associated with the value set in the source the same as the identifier in the IG
      4. Spot check on the first 3 codes in the IG to confirm they are present in the source value set

Confirm all value set bindings

      1. Did you find any places where there is a STATIC binding and no date information? Add a date if appropriate.
      2. Did you find any places where there is a STATIC binding that should be DYNAMIC? Change to DYNAMIC if appropriate.
      3. Did you find any places where there is a valueSet binding and no Binding Stability (i.e. no STATIC and no DYNAMIC term included)? Add the correct Binding Stability for the value set binding.

Confirm No Terminology Related Errors in IG Publishing Tool.


  •  Complete

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:

  1. Confirm that the sample file passes Schema validation without any errors.
  2. Confirm that the sample file passes Schematron validation without any errors. 

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.


  •  Complete

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


  •  Complete

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
https://hl7.org/permalink/?CDAR2.0schema
https://hl7.org/permalink/?CDAR2.1schema

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:

        • Does it fully describe all the files that are in the package?
        • Are the correct file names used?
        • Does it correctly point to the right GitHub repo and identify the files that are available in the repo?
          • Does the repo contain the required sample files?
          • Does the repo contain the required Schematron?
          • Does the repo contain any referenced specialized stylesheets?
          • Do the sample files validate without Schema or Schematron errors?
        • Are permalinks to the CDA Schema and CDA Sample Stylesheet used in the _Readme.txt file?

Link to _Readme.txt template (template includes text to be updated): _Readme.txt Template

  •  Complete

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:

    • Apply the form instructions to determine if the request has been filled out correctly and clearly.
    • Confirm the Specification Name is specified correctly, according to current TSC Naming Guidelines.  If the Specification name does not meet current TSC Naming Guidelines, use the form to request a new name for the specification for use when published. 
    • Confirm descriptions are worded clearly and are consistent with information supplied within the IG.
    • Open the PSS and review the NIB history to confirm the progression of the Product edition and ballot level (INF, STU, NORM) and ballot iteration (1,2,3)
    • *To view the NIB History, after opening the SPECIFIC PSS, Click on the link labeled View Ballot Items List (with NIBs), located near the top of the page, to the right of the PSS number.
    • Open the ballot desktop and confirm the ballot cycle and file name under which the artifact was balloted.


Example: Project 210: QRDA Draft Standard for Trial Use
https://www.hl7.org/special/Committees/projman/searchableProjectIndex.cfm?action=edit&ProjectNumber=210
Click on the link labeled View Ballot Items List (with NIBs) and you'll see this:
https://www.hl7.org/special/Committees/tsc/ballotmanagement/pi_index_nibs.cfm?ProjectNumber=210

  •  Complete

Initials: GC

Date: 2023-03-20

Notes 

Publication Request in HL7 CDA Pharmacy Template STU2


checked

https://www.hl7.org/special/Committees/projman/searchableProjectIndex.cfm?action=edit&ProjectNumber=1139

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:


  •  Complete

Initials: 2023-03-20GC

Date: 2023-03-20

Notes 


--------------------------------------------------Steps to complete the vote CMG ONLY -------------------------------------------------

...