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

Table 6. Declarations defined by FSH unclear

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Not Persuasive with Modification
    • Icon: Medium Medium
    • Shorthand (FHIR)
    • 1.0.0
    • FHIR Infrastructure
    • Language Reference
    • 3.5.1.2
    • Hide

      The spec makes a clear distinction between Declarations and Keywords.

      In 3.5.1.1, the spec states that "A declaration is always the first statement in an item definition. The value represents the item’s name or identifier (id)." It then gives a list of Declarations.

      In 3.5.1.2, the spec states "Keyword statements directly follow the declaration and precede any rules." It then gives a list of Keywords.

      Therefore, in Table 6, which follows immediately thereafter, it should be clear what is meant by Declarations and Keywords. 

      We do not believe a change is necessary in this case because the definitions are clear and located just before the table in question.

       

      However, the language in 2.1.2 can be improved by using "Declarations" instead of "Keyword" and "Declarative Keyword", so that section will be updated to do so.

      Show
      The spec makes a clear distinction between Declarations and Keywords. In 3.5.1.1, the spec states that "A declaration is always the first statement in an item definition. The value represents the item’s name or identifier (id)." It then gives a list of Declarations. In 3.5.1.2, the spec states "Keyword statements directly follow the declaration and precede any rules." It then gives a list of Keywords. Therefore, in Table 6, which follows immediately thereafter, it should be clear what is meant by Declarations and Keywords.  We do not believe a change is necessary in this case because the definitions are clear and located just before the table in question.   However, the language in 2.1.2 can be improved by using "Declarations" instead of "Keyword" and "Declarative Keyword", so that section will be updated to do so.
    • Mark Kramer / Bas van den Heuvel : 11 - 0 - 5
    • Clarification
    • Non-substantive

    Description

      Table 6, Hard to understand what is actually meant by it.
      Here the left column is called declarations (Alias, Code system etc.) while these items in the overview 2.1.2 are called keywords.
      What is the difference between declarations and keywords. In the example in the overview on line 4 a profile is defined and in line 5 a parent is defined. Syntactically it is the same but one is a keyword and the other is a declaration. Why the semantic difference?

      Attachments

        Activity

          People

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

            Dates

              Created:
              Updated:
              Resolved: