Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-41896

Assure clear definitions up front

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Highest Highest
    • Canonical Resource Management Infrastructure (FHIR)
    • 1.0.0-ballot [deprecated]
    • Clinical Decision Support
    • STU
    • Home
      Introduction
    • Hide

      Agreed, provide clear definitions of:

      • canonical resource - Canonical resources are defined by the FHIR specification (link) as resources that have a url element as a special business identifier. These resources are expected to contain substantively the same content regardless of the server on which they appear.
      • knowledge artifact - Knowledge artifacts are resources that are primarily definitional in nature (i.e. they contain patient-independent information such as profiles, extensions, value sets, measures, and decision support rules, as opposed to patient-specific information such as procedures, observations, and encounters).
      • NPM - Node Package Manager (link)
      Show
      Agreed, provide clear definitions of: canonical resource - Canonical resources are defined by the FHIR specification (link) as resources that have a url element as a special business identifier. These resources are expected to contain substantively the same content regardless of the server on which they appear. knowledge artifact - Knowledge artifacts are resources that are primarily definitional in nature (i.e. they contain patient-independent information such as profiles, extensions, value sets, measures, and decision support rules, as opposed to patient-specific information such as procedures, observations, and encounters). NPM - Node Package Manager (link)
    • Floyd Eisenberg/Greg White: 13-0-0
    • Enhancement
    • Non-substantive

    Description

      The IG is well formed.  This comment is about clarity of terms even though the expected audience will likely understand them.

      The term "canonical" is used frequently in discussions but if this IG is to address canonical resource management, a clear definition is important. The FHIR definition to which the IG links states "Some resource types have a defined element url which is the 'canonical URL' that always identifies the resource. This is a special kind of Business Identifier. Note that the element actually contains a URI, but is named url for legacy reasons." Still, the definition is a bit circular since it uses the term being defined in the definition.  

      Also for the list of canonical resources, it will be helpful to define what is canonical and what is non-canonical in the resource type section 1.1.1 - and specifically explain what is meant by roadmap item, and what to do with uses EBM resources.  Some clarification would help in the language describing this list.

      Also diagram uses NPM - need to define - Node Package Manager

      https://registry.fhir.org/learn

      Attachments

        Activity

          People

            Unassigned Unassigned
            feisenberg Floyd Eisenberg
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: