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

Glossary should define concepts not reference them

    XMLWordPrintableJSON

Details

    • Icon: Technical Correction Technical Correction
    • Resolution: Persuasive
    • Icon: Medium Medium

    Description

      The glossary is not so much a "glossary" per se (MW Dictionary defines as "a collection of textual glosses or of specialized terms with their meanings") as it is a References page (referencing various codes and profiles within the IG).

      The Descriptions used in the table seem more appropriate in the Detailed Descriptions page included in each profile. A "Glossary" should be used as a place to define Terms/Concepts referenced throughout the guide (i.e. variant, allele, genotype, phenotype, ACMG, etc) to aid the non-genetics expert reader in understanding what was meant.

      As a best practice, terms should not self-define (example: "mode of inheritance" defined as "mode of inheritance") and include an authoritative source where the definition originated.

      If this is not the intent/scope of this Appendix, I would suggest renaming.

      Attachments

        Activity

          People

            Unassigned Unassigned
            liz.amos Liz Amos
            Watchers:
            5 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: