Stream: terminology
Topic: Code System Definition
Grahame Grieve (Feb 10 2018 at 12:56):
GF#14726 - the code system definition is a copy/paste from value set, and has to be fixed.
Rob Hausam (Feb 11 2018 at 06:59):
Yes. We also have GF#13450 and GF#14242 on the same subject.
Grahame Grieve (Feb 11 2018 at 10:56):
so should we wordsmith something here?
Rob Hausam (Feb 11 2018 at 21:07):
yes - I was planning to come up with a suggestion
I can post something (or you can) and we can also discuss it on the Vocab tracker issues call tomorrow, if needed
Grahame Grieve (Feb 12 2018 at 19:28):
well something along the lines of
A code system resource represents the definition of a set of concepts in a controlled framework which assigns codes to represent the concepts, designations that describe them, and properties and filters to help compute with them
Russ Hamm (Feb 12 2018 at 19:30):
Are we inventing a new definition, or should we pull/align with Core Principles or the Glossary Project?
Grahame Grieve (Feb 12 2018 at 19:36):
we should probably align, but given that we are defining a CodeSystem resource, not a Code System, it will be slightly different.
Grahame Grieve (Feb 12 2018 at 19:36):
the key difference between that a code system is one representation of the concept of a code system
Rob Hausam (Feb 12 2018 at 19:51):
yes - it's the definition of the resource, not of "code system" itself
I'll work more on the wording before to the tracker issues call
Russ Hamm (Feb 12 2018 at 20:01):
Got it. Thanks Grahame.
Rob Hausam (Feb 12 2018 at 21:27):
We affirmed on the tracker issues call to use the definition: "The CodeSystem resource is used to declare the existence of a code system and its key properties."
Grahame Grieve (Feb 12 2018 at 23:29):
well, ok, but I'll put on my Lloyd hat and say 'that's tautological'
Richard Townley-O'Neill (Feb 12 2018 at 23:33):
It is also clarificatory. I see people confuse instances of the CodeSystem resource with code systems.
Michael Lawley (Feb 13 2018 at 01:15):
It's also often used to do more than declare the existence of a code system, it's used to actually describe it and in some cases define it.
Lloyd McKenzie (Feb 13 2018 at 01:49):
Keep in mind that implementers of FHIR are not expected to be familiar with nor read Core Principles.
Grahame Grieve (Feb 13 2018 at 03:31):
no so we won't reference it, but we do want to be consistent
Rob Hausam (Feb 13 2018 at 04:21):
I agree that definition leaves out the "describe" and "define" bits that Michael mentioned. Here's an attempt that is more wordy but also more complete: "The CodeSystem resource is used to declare the existence of and describe a code system or code system supplement and its key properties, and optionally define a part or all of its content."
We can change the proposed resolution of GF#14726 to this, if there is agreement. The plan is to vote on this in the block on the Main Vocab call next Thursday (2/22).
Grahame Grieve (Feb 13 2018 at 09:16):
I'm happy with that
Last updated: Apr 12 2022 at 19:14 UTC
