Search


Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To provide consistency and clarity, there has been an effort to use certain styles and specific terms within the Editorial Guide.

Although this has been the intent, it is the content of the Guide that has been the focus. Consequently, authors may find instances where alternative styles or terms are used.

Style
TypeNotes
Italics
  • To emphasize a word in a sentence or phrase
  • To indicate the name of something

Upper case first letter

  • To emphasize a word in a sentence or phrase not necessarily at the beginning

Periods.

Not used in:

Note
titleDon't do this


  • Lists when items contained therein are not sentences
  • At the end of sentences within tables
Examples
  • Presented as:

For example,

      • text of example
  • When possible, examples from the SNOMED CT browser are provided. When examples from the browser are not available, i.e do not yet exist, they are obtained from other sources

Macros: 

  • Note = yellow
    • For example
    • For more information
  • Tip = green
    • For example
    • Concept modeling
    • URLs
  • Warning = red
    • Exceptions
  • Info = blue

General

Note
titleFor more information

Contains general information or additional resource (may be a link)


Tip
titleModeling

Contains modeling information


Warning
titleException or Inactivation or Under Revision

Contains information about content exceptions, inactivation, or under revision


Info
titleHello

Informational box


Specific




Tables

  • Heading row - light green fill; bold font
  • Sub-heading row - light blue fill
  • Column heading - light blue fill
  • Other cells - may have pink fill for emphasis
  • Footing row - light yellow fill


Heading row















Footing row

Note: Tables generated from the Human Readable Concept Model have unique formatting

Text formats

  • "Quotation marks"
  • Bold font
  • ALL CAPS
  • Minimally used
Page headings
  • Section headings - Heading 2

  • Subsection headings - Heading 3























































Terms
Used in GuideSynonym / Other
AttributeConcept Model Attribute; Relationship type
Authoring platformSCA tool
ChildSubtype,
Subtype child
Immediate subtype
ClassifierDescription logic (DL) classifier;Logic reasoner
DescendantChild
and
, Subtype, child/children
DomainConcept model domain
Electronic health applicationSoftware application; Clinical information systems
Electronic health record or EHRElectronic medical record; Electronic record; Electronic patient record
ExtensionSNOMED CT extension, Member/Affiliate-Added Terminology
Grouping concept/GrouperNA
Inactivate/InactivationRetire*
International ReleaseCore
Material entityMaterial agent
Modeler/ModelingAuthor/Authoring, Editor/Editing
ParentSupertype,
Supertype parent
Immediate supertype
PrecoordinatedPrecoordinated expression
PostcoordinatedPostcoordinated expression
QualifierQualifying characteristic
RangeConcept model range, Allowable value
Relationship
Role group
Role
Relationship group
Root conceptTop-level concept
Semantic tagSemantic type, Hierarchy tag, Hierarchy designator
Situation with Explicit ContextContext-dependent Category
Sufficiently defined

Fully defined*

*Strikethrough = No longer used