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

Clarify Data Type Names section

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive
    • Icon: Medium Medium
    • Using CQL With FHIR (FHIR)
    • 1.0.0-ballot
    • Clinical Decision Support
    • STU
    • Using CQL
    • 2.9
    • Hide

      Agreed, move Conformance Requirement 2.14 to the ModelInfo documentation, and:

      1. Revise the language to a SHOULD use "Title Case" instead of "Pascal Case"
      2. Provide a section defining "PascalCase", "camelCase", and "Title Case" and provide definitions of each

      In addition, clarify the definition of a "Data Type" with respect to CQL and provide links back to the CQL specification to support this usage.

      Show
      Agreed, move Conformance Requirement 2.14 to the ModelInfo documentation, and: 1. Revise the language to a SHOULD use "Title Case" instead of "Pascal Case" 2. Provide a section defining "PascalCase", "camelCase", and "Title Case" and provide definitions of each In addition, clarify the definition of a "Data Type" with respect to CQL and provide links back to the CQL specification to support this usage.
    • Chris Moesel / Juliet Rubini : 23-0-0
    • Clarification
    • Non-substantive

    Description

      The Data Type Names section has some confusing aspects to it and should be clarified.

      Some readers may not know what PascalCase is, so consider defining it or linking to a definition of it.

      If users know what PascalCase is, they may be confused by Conformance Requirement 2.14, which says "Use PascalCase plus appropriate spacing" since PascalCase does not allow spacing. What is "appropriate spacing" in this case?

      This is expressed as a requirement for CQL, but aren't CQL authors at the mercy of the ModelInfo? If the ModelInfo names a datatype using camel case, I don't think the CQL author has any choice but to use camel case, do they? Should this be expressed as a requirement for ModelInfo rather than CQL?

      Attachments

        Activity

          People

            bryn.rhodes Bryn Rhodes
            cmoesel Chris Moesel
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: