You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
from Hook Maturity section, to Changes to a Hook.
Rename "Changes to the Definition of a Hook (Hook Versioning)" to "Changes to a Hook" to incorporate hook maturity
Copy file name to clipboardExpand all lines: docs/specification/1.0.md
+8-3Lines changed: 8 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -873,7 +873,7 @@ Hook creators SHOULD include examples of the context.
873
873
If the context contains FHIR data, hook creators SHOULD include examples across multiple versions of FHIR if differences across FHIR versions are possible.
874
874
875
875
### Hook Maturity Model
876
-
The intent of the CDS Hooks Maturity Model is to attain broad community engagement and consensus, before a hook is labeled as mature, that the hook is necessary, implementable, and worthwhile to the CDS services and CDS clients that would reasonably be expected to use it. Implementer feedback should drive the maturity of new hooks. Diverse participation in open developer forums and events, such as HL7 FHIR Connectathons, is necessary to achieve significant implementer feedback. The below criteria will be evaluated with these goals in mind. The hook definition defines the hook's current maturity level and MUST link to the definition of that maturity level.
876
+
The intent of the CDS Hooks Maturity Model is to attain broad community engagement and consensus, before a hook is labeled as mature, that the hook is necessary, implementable, and worthwhile to the CDS services and CDS clients that would reasonably be expected to use it. Implementer feedback should drive the maturity of new hooks. Diverse participation in open developer forums and events, such as HL7 FHIR Connectathons, is necessary to achieve significant implementer feedback. The below criteria will be evaluated with these goals in mind.
6 | Normative | _The above, and ..._ the responsible HL7 working group and the CDS working group agree the material is ready to lock down and the hook has passed HL7 normative ballot
891
891
892
892
893
-
### Changes to the Definition of a Hook (Hook Versioning)
893
+
### Changes to a Hook
894
894
895
895
Each hook MUST include a Metadata table at the beginning of the hook with the specification version and hook version as described in the following sections.
896
896
@@ -932,9 +932,14 @@ When a major change is made, the hook definition MUST be published under a new n
932
932
933
933
> Note that the intent of this table is to outline possible breaking changes. The authors have attempted to enumerate these types of changes exhaustively, but as new types of breaking changes are identified, this list will be updated.
934
934
935
+
#### Hook Maturity
936
+
As each hook progresses through a process of being defined, tested, implemented, used in production environments and balloted, the hook's formal [maturity level](#hook-maturity-model) increases. Each hook has its own maturity level, which MUST be defined in the hook's definition and correspond to the [Hook Maturity Model](#hook-maturity-model).
937
+
938
+
hookMaturity | [0 - Draft](#hook-maturity-model)
939
+
935
940
#### Change Log
936
941
937
-
Changes made to a hook MUST be documented in a change log to ensure hook consumers can track what has been changed over the life of a hook. The change log MUST contain the following elements:
942
+
Changes made to a hook's definition MUST be documented in a change log to ensure hook consumers can track what has been changed over the life of a hook. The change log MUST contain the following elements:
938
943
939
944
- Version: The version of the change
940
945
- Description: A description of the change and its impact
0 commit comments