Skip to content

Conversation

@beauvangemert1990
Copy link
Collaborator

Align with FHIR ShEx

@rolandgroen rolandgroen self-requested a review December 3, 2025 15:34
Copy link
Contributor

@rolandgroen rolandgroen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR Review

Summary

This PR updates the RDF observation documentation in dynamic-data.md and extends the WellDataObservation profile to support additional value types (dateTime, string).

What's Good

  • Profile and documentation are now aligned - the FSH profile supports all value types shown in the RDF example
  • Version bump and changelog are properly updated
  • Whitespace cleanup improves consistency

Issues

1. Invalid RDF/Turtle Syntax in Mock Example

The mock observation shows 4 separate fhir:value statements, each ending with . (period):

fhir:value [ ... ] .  # ends the subject
fhir:value [ ... ] .  # orphaned - no subject
fhir:value [ ... ] .  # orphaned
fhir:value [ ... ] .  # orphaned

In Turtle, . terminates a statement about a subject. Only the first fhir:value is actually attached to the observation - the other three are syntactically invalid/orphaned.

Suggestion: Show each value type as a separate commented-out alternative, or create 4 mini-examples with distinct subjects.

2. CodeableConcept Example Uses Wrong Structure

The profile supports CodeableConcept, but the RDF example shows:

fhir:value [
  fhir:coding ( [ ... ] )
]

This should be wrapped as:

fhir:value [
  a fhir:CodeableConcept ;
  fhir:coding ( [ ... ] )
]

3. Practical Examples Removed

The previous documentation had individual RDF examples for specific observations (cholesterol ratio, HDL, height, weight, BMI, waist circumference, blood pressure). These practical examples are now gone.

Suggestion: Either restore simplified versions, or add a note pointing readers to the FSH example instances in input/fsh/instances/example-welldata-observation.fsh.

@beauvangemert1990
Copy link
Collaborator Author

@rolandgroen
I handled your comments, can you take a look?

Also added a comment on the importance of writing individual observations with uuid's in the observation folder.

@rolandgroen rolandgroen merged commit 6d4da3b into main Dec 4, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants