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

An issue with readability 2

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Persuasive with Modification
    • Icon: High High
    • Shorthand (FHIR)
    • 0.12.0 [deprecated]
    • FHIR Infrastructure
    • Language Reference
    • 1.3.3
    • Hide

      This is a very good suggestion and it will clarify the content considerably. The Overview should not contain this level of detail, but in the place of the former table, there is now a reference to a new table in the language specification that follows this suggestion.

      Show
      This is a very good suggestion and it will clarify the content considerably. The Overview should not contain this level of detail, but in the place of the former table, there is now a reference to a new table in the language specification that follows this suggestion.
    • Moesel/Rhodes 11-0-1
    • Correction
    • Compatible, substantive

    Description

      I would suggest to switch from using the lists with items enumerated within round brackets to using tables where, e.g., one has the left column containing the keyword and the top row containing the item names. The table elements are then V for the matches. Also, in thos table one is to make clear that what are items and what are keywords. When reading the text as it is now, it requires some extrra time to understand what you mean.

      Existing Wording:

      Keywords common to several types of items include:

      Specialized keywords, used only with one type of item include:

      Attachments

        Activity

          People

            Unassigned Unassigned
            ivan_zapreev Ivan Zapreev (Inactive)
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: