Vocab QA Requirements

This is the working collaboration page for documenting the issues and requirements to be addressed by the project. This page will begin to put together the ideas from which the document will eventually be produced.

Scope Items

Product Families

1. Version 2
2. Version 3
3. CDA
4. FHIR

Vocabulary Objects

1. HL7 Defined Code Systems
2. HL7 Authored and Published Value Sets

Common Elements Across Families

1. Code system Identifiers
2. Value Set metadata

Draft list of issues for discussion

1. Multi-code system value sets and their use in extensible bindings
2. Use of value sets to control better use of null flavor
3. Value set versioning
4. Use of static binding
5. Clarify use of immutable value set: ActClassProcedure – good example
6. Not just value set – all terminology issues
7. V2 table content issues
8. Incorrect OID identifier and name of object
9. Inconsistency in naming conventions
10. Terminology source of truth for artifacts
11. Terminology in the context of ballot review
12. If a code system is represented in an HL7 spec, the code system:
    1. Needs an identifier "known to HL7 users"
    2. Has a documented steward
13. Example of situation that should be avoided
    1. Abnormal / Interpretation flags in v2 lab / v3 lab

List of principles

This is a working list to document general principles to be implemented with processes to achieve a higher level of quality in the HL7 Vocabulary management processes across the product families.

1. Assessment of fitness for purpose of new value sets

• Scope and Range of proposed Value Set

1. Assessment of both fitness for purpose and possible negative effects of proposed changes

Initial Ideas for Requirements

We really want to have all of these be SHALLs, but we recognize there may be issues around broad use.

1. Review process should be asynchronous
2. Review process should invite contributions from both members and non-members
3. Tooling should be used to ensure technical accuracy

• Proposed content ready for use at time of submission
• Proposed content should be free of spurious editorial error or structural mistakes (missing requirement elements, etc.)
• Proposed content should be in a formal artifact and well structured

1. Tooling should be broadly available to enable creation and update of VSDs
2. Tooling should be broadly available to enable creation and update of HL7 code systems
3. Tooling must support the format for implementation use of the value sets and other vocabulary objects across all families

• Ideally the tooling should provide a single set of capabilities and UI, and the product family differences are 'under the covers' in the background

1. It would be nice if the tooling did the automatic items, such as and OID is created automatically when a FHIR value set is created

General Notions and Comments

• Some requirements are driven by the underlying code system requirements
• Some requirements are driven by the product family
• We should try to ensure that all value sets created are usable across product families
• The current notion is that a value set expansion contains a particular set of concepts from underlying terminologies, but different expansions made from the same VSD may have differences in additional baggage; but all must have the same set of concepts
• Our processes should ensure that whatever gets submitted is consistent with what our documented notions of what value sets actually are.
• Our processes should allow for the possibility that validation requirements for value sets may vary based on the product family or models they are being designed for use with.
• See if our tooling and practices can make effective use of social media so that the review process can scale by taking advantage of crowd-sourcing notions

Systematic Approach

1. Alternative approaches:
   1. Gather Input by meeting with key collaborator for each product family to find issues
      1. Decided against this. Decided to build stawman to discuss with product families first.
   2. Develop and initial strawman then review with product families
      1. Document process
         1. Incrementally add specificity over time
         2. Focus on critical areas and allow other items to not change initially
            1. Identify common elements across all families but are not approached in same way
      2. Incremental build of supporting tooling
         1. Can we have tooling that changes as requirements change