Skip to content

Fix incorrect CDS response examples in Health Tool documentation#10207

Open
Nadeesha-D-Shalom wants to merge 5 commits intoballerina-platform:masterfrom
Nadeesha-D-Shalom:fix-health-tool-cds-response
Open

Fix incorrect CDS response examples in Health Tool documentation#10207
Nadeesha-D-Shalom wants to merge 5 commits intoballerina-platform:masterfrom
Nadeesha-D-Shalom:fix-health-tool-cds-response

Conversation

@Nadeesha-D-Shalom
Copy link

Corrects the CDS template generation documentation to display valid CDS Hooks responses.

The documentation previously showed FHIR resource examples (e.g., Practitioner) as CDS responses, which is incorrect and confusing for users. This change replaces those examples with proper CDS card-based responses that align with the CDS Hooks 2.0 specification.

This improves accuracy, clarity, and developer experience when using the Health Tool for CDS service generation.

Minor capitalization fixes for consistency without altering policy meaning.
This PR fixes minor capitalization inconsistencies in the privacy policy to improve grammatical consistency, without altering the policy meaning or intent.
Standardized capitalization for "Hello World" titles to improve consistency across the navigation.
Fix capitalization of “Hello World” titles in BBE navigation
Corrects the CDS template generation documentation to show
proper CDS card responses instead of FHIR resource examples.
@CLAassistant
Copy link

CLAassistant commented Dec 29, 2025

CLA assistant check
All committers have signed the CLA.

@Nadeesha-D-Shalom
Copy link
Author

The CDS template generation section of the Health Tool documentation contained incorrect response examples. Specifically, FHIR resource JSON outputs were shown where CDS card responses should be returned.

This change fixes the documentation to reflect actual CDS Hooks responses generated by the tool, ensuring correctness and preventing confusion for developers.

Fixes #10192

url: learn/by-example
sublinks:
- title: Language concepts
- title: Language Concepts
Copy link
Contributor

Choose a reason for hiding this comment

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

In ballerina.io we use the sentence case. Please revert the changes.

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.

3 participants