Skip to content
This repository has been archived by the owner on May 7, 2024. It is now read-only.

Review and Updates to Procedure #1016

Merged
merged 7 commits into from
Nov 30, 2023
Merged

Conversation

RicardoCrespo-ora
Copy link
Contributor

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
image

After
image


Parameter table formatting and corrections

Before
image

After
image

Notes corrections and formatting

Before
image

After
image

PR Checklist

  • Screenshot(s) of changes attached before changes merged.
  • Screenshot(s) of changes attached after changes merged and published.

@RicardoCrespo-ora RicardoCrespo-ora added R4 Applies to R4 FHIR resources DSTU2 Applies to DSTU2 FHIR resources labels Nov 9, 2023
@RicardoCrespo-ora
Copy link
Contributor Author

Added some of the wording suggested in #1006

Copy link
Contributor

@kckeim kckeim left a 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"}
Copy link
Contributor

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.

Comment on lines 19 to 25
* [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"}
Copy link
Contributor

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

Comment on lines 57 to 59
`_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`
Copy link
Contributor

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.
Copy link
Contributor

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.
Copy link
Contributor

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)

Copy link
Contributor Author

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

Copy link
Contributor

@cldeitrich cldeitrich left a 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.

@RicardoCrespo-ora RicardoCrespo-ora merged commit 832c6a1 into main Nov 30, 2023
1 check passed
@RicardoCrespo-ora RicardoCrespo-ora deleted the procedure-docs-migrate branch November 30, 2023 15:08
Surya-Rnsit pushed a commit that referenced this pull request Dec 14, 2023
* 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)
@SukeshKonjeti
Copy link
Contributor

After code deployment :

Screenshot 2023-12-14 at 6 15 16 PM Screenshot 2023-12-14 at 6 15 26 PM

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
DSTU2 Applies to DSTU2 FHIR resources R4 Applies to R4 FHIR resources
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants