Apply suggestions from Josh's code review

Making changes requested by Josh

Co-Authored-By: mattvarghese <[email protected]>

Author: jmandel

docs/hooks/medication-prescribe.md

@@ -9,7 +9,7 @@
 
 ## Deprecation Notice
 
-This hooks is being deprecated in favor of the `order-select` and `order-sign` hooks. The workflow during which this hook fires is unclear and has led to varying implementations and confusion. Also, this hook does not allow for procedure orders even though the workflow usually includes both medication and procedure orders. Therefore, after discussions on Zulip, and the HL7 CDS Committee, the `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. Native criteria within the EHR will be relied upon to only fire the new hooks for appropriate medications / procedures. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
+This hook is deprecated in favor of the `order-select` and `order-sign` hooks, with the goal of  clarifying workflow trigger points and supporting orders beyond medications. In this refactoring, `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
 
 ## Workflow
 

docs/hooks/order-review.md

@@ -8,7 +8,7 @@
 
 ## Deprecation Notice
 
-This hooks is being deprecated in favor of the `order-sign` hook. The workflow during which this hook fires is unclear and has led to varying implementations and confusion. Therefore, after discussions on Zulip, and the HL7 CDS Committee, the `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. Native criteria within the EHR will be relied upon to only fire the new hooks for appropriate medications / procedures. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
+This hook is deprecated in favor of the `order-sign` hooks, with the goal of  clarifying workflow trigger points and supporting orders beyond medications. In this refactoring, `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
 
 ## Workflow