-
Notifications
You must be signed in to change notification settings - Fork 113
Conversation
Added some of the wording suggested in #1006 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tagged a few items directly for lines you touched.
For non-edited lines that need attention...
DSTU2 markdown:
- Need to consolidate the disclaimer and common errors+outcomes section to follow the fields list at the top
- "Retrieve by id" section needs to have the id uppercased in the header and description.
R4 markdown:
- Need to consolidate the disclaimer and common errors+outcomes section to follow the fields list at the top
- "Retrieve by id" section needs to have the id uppercased in the header and description.
- Under the "Create" section, you can drop that second implementation note; it's already handled by the first line.
- Remove "Modifier fields should not be provided, and will cause the transaction to fail."
DSTU2 Procedure.yaml
- Could we please https-ify the URLs and Info Links? R4's yaml appears okay after my glance through.
* [Notes](http://hl7.org/fhir/DSTU2/procedure-definitions.html#Procedure.notes){:target="_blank"} | ||
* [ID](https://hl7.org/fhir/dstu2/resource-definitions.html#Resource.id){:target="_blank"} | ||
* [Patient](https://hl7.org/fhir/DSTU2/procedure-definitions.html#Procedure.subject){:target="_blank"} | ||
* [Status (completed, entered-in-error)](https://hl7.org/fhir/DSTU2/procedure-definitions.html#Procedure.status){:target="_blank"} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You can drop the parentheses on Status here. Just saying the field can return is enough.
* [ID](https://hl7.org/fhir/R4/resource-definitions.html#Resource.id){:target="_blank"} | ||
* [Status (completed, entered-in-error)](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.status){:target="_blank"} | ||
* [Code](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.code){:target="_blank"} | ||
* [Subject](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.subject){:target="_blank"} | ||
* [Reference](http://hl7.org/fhir/r4/references.html#Reference){:target="_blank"} ([Patient](http://hl7.org/fhir/r4/patient.html){:target="_blank"}) | ||
* [Encounter](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.encounter){:target="_blank"} | ||
* [Date performed](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.performed_x_){:target="_blank"} | ||
* [Performed Period](https://hl7.org/fhir/R4/procedure-definitions.html#Procedure.performed_x_){:target="_blank"} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same as on DSTU2 - drop the Status field's parenthetical values, please
`_id` | Conditionally | [`token`] | The logical resource id associated with the resource. This parameter is required if `patient` or `subject` are not used. | ||
`patient` | Conditionally | [`reference`] | Who the Procedure is for. This parameter is required if `_id` or `subject` are not used. Example: `12345` | ||
`subject` | Conditionally | [`reference`] | Who the Procedure is for. This parameter is required if `_id` or `patient` are not used. Example: `Patient/12345` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Wording on the parameters here should be used in DSTU2 resource's table as well.
- The `_id` parameter may not be provided at the same time as the `patient`, `subject`, or `date` parameters. | ||
|
||
- The `date` parameter must have a time, may be provided up to two times, and must use the `ge` or `le` prefixes. When provided twice, the lower value must have the `ge` prefix and the higher value must have the `le` prefix. | ||
* The `_id` parameter may not be provided at the same time as the `patient`, `subject`, or `date` parameters. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Drop the conditional requirement line here, and use the descriptions in the R4 resource's table over on this DSTU2 resource, please. Your fixes in the R4 file match what the technical writers are looking for.
`patient` | Conditionally | [`reference`] | Who the Procedure is for. This parameter is required if `_id` or `subject` are not used. Example: `12345` | ||
`subject` | Conditionally | [`reference`] | Who the Procedure is for. This parameter is required if `_id` or `patient` are not used. Example: `Patient/12345` | ||
`date` | No | [`dateTime`] | Date range in which the Procedure's `performedPeriod` or `performedDateTime` falls within. Example: `date=gt2015-09-24T12:00:00.000Z&date=le2020-07-15T16:00:00.000Z` | ||
`_revinclude` | No | [`token`] | Provenance resource entries to be returned as part of the bundle. Example:_revinclude=Provenance:target | ||
|
||
Notes: | ||
|
||
* If `_id` is provided, `patient` or `subject` can no longer be provided. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you still use date if _id
is used?
I thought it flipped over to basically:
If searching with the _id
parameter, you cannot use any other parameters (except for _revinclude as detailed)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removed the id note to avoid confusion
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
PRODOC-203452: Approved for style.
* Updated DocumentReference DSTU2 Resource (#998) * Updated InsurancePlan R4 Resource (#1000) * Updated Immunization DSTU2 Resource (#1003) * Updated Immunization R4 Resource (#1004) * Review and Updates for FamilyMemberHistory (#1013) * Review and Updates to Procedure (#1016) * Patient Arrival Time (#1017) * Update FHIR documentation for RevInclude supported resources (#1024) * CapabilityStatement R4 Response Examples Update (#1025) * [Millennium-R4]: Reschedule Appointment Workflow Update (#1026)
Description
In preparation for migrating to Oracle docs, we are reviewing and correcting any inconsistencies, typos, broken links, etc. This PR aims to correct any of the above that needs to be addressed within FamilyMemberHistory and any other information directly referenced by it.
Capitalization and corrections to returned fields
Before
After
Parameter table formatting and corrections
Before
After
Notes corrections and formatting
Before
After
PR Checklist