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

Is the Guidance chapter informative?

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive with Modification
    • Icon: Highest Highest
    • US Core (FHIR)
    • 4.1.0 [deprecated]
    • Cross-Group Projects
    • STU
    • Guidance
    • Hide

      Background:

      The General Guidance section is intended to document both requirements, clarifications and informative guidelines that apply in general and across the guide as it states in its introduction:

      This section outlines important definitions, interpretations, and requirements common to all US Core actors used in this guide. The conformance verbs  SHALLSHOULDMAY  used in this guide are defined in FHIR Conformance Rules.  

       

      FHIR Conformance language:

      2.1.0.1 Conformance Language 

      This specification uses the conformance verbs SHALL, SHOULD, and MAY as defined in RFC 2119. Unlike RFC 2119, however, this specification allows that different applications might not be able to interoperate because of how they use optional features. In particular:

      1. SHALL: an absolute requirement for all implementations
      2. SHALL NOT: an absolute prohibition against inclusion for all implementations
      3. SHOULD/SHOULD NOT: A best practice or recommendation to be considered by implementers within the context of their particular implementation; there may be valid reasons to ignore an item, but the full implications must be understood and carefully weighed before choosing a different course
      4. MAY: This is truly optional language for an implementation; can be included or omitted as the implementer decides with no implications

      Reasoning:

      We acknowledge that there is a mixture of required and informative content and agree it may be clearer for the reader to clearly distinguish between them.

      Proposed Changes:

      1. The content will be split into three page
        1. "USCDI
        2. "General Requirements Page"
          1. mandatory content
          2. optional content - clarify what the conformance language means when for optional topic is supported.
        3. "General Guidance: for informative content
      Show
      Background: The General Guidance section is intended to document both requirements, clarifications and informative guidelines that apply in general and across the guide as it states in its introduction: This section outlines important definitions, interpretations, and requirements common to all US Core actors used in this guide. The conformance verbs   SHALL ,  SHOULD ,  MAY   used in this guide are defined in  FHIR Conformance Rules .     FHIR Conformance language: 2.1.0.1 Conformance Language  This specification uses the conformance verbs SHALL, SHOULD, and MAY as defined in RFC 2119. Unlike RFC 2119, however, this specification allows that different applications might not be able to interoperate because of how they use optional features. In particular: SHALL: an absolute requirement for all implementations SHALL NOT: an absolute prohibition against inclusion for all implementations SHOULD/SHOULD NOT: A best practice or recommendation to be considered by implementers within the context of their particular implementation; there may be valid reasons to ignore an item, but the full implications must be understood and carefully weighed before choosing a different course MAY: This is truly optional language for an implementation; can be included or omitted as the implementer decides with no implications Reasoning: We acknowledge that there is a mixture of required and informative content and agree it may be clearer for the reader to clearly distinguish between them. Proposed Changes: The content will be split into three page "USCDI "General Requirements Page" mandatory content optional content - clarify what the conformance language means when for optional topic is supported. "General Guidance: for informative content
    • Eric Haas / Bas van den Heuvel: 15-0-0
    • Enhancement
    • Non-substantive

    Description

      Is the contents of this section optional or mandatory?

      Guidance seems to suggest all of this optional, the content suggests otherwise. 

      I also suggest that for each topic in the chapter it is indicated what the mandatory status is. In the case of an optional element, the mandatory text in the section is applicable only when the optional element is supported.

      Attachments

        Activity

          People

            Unassigned Unassigned
            bvdh Bas van den Heuvel
            Bas van den Heuvel
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: