Skip to content

docs: point data-integration value set links at tx.fhir.org - #46

Open
Nesmeshnoy wants to merge 1 commit into
mainfrom
fix/data-integration-vsac-links
Open

docs: point data-integration value set links at tx.fhir.org#46
Nesmeshnoy wants to merge 1 commit into
mainfrom
fix/data-integration-vsac-links

Conversation

@Nesmeshnoy

Copy link
Copy Markdown
Contributor

The five VSAC links in the data-integration section do not open. VSAC serves a single-page app behind a UMLS login: it answers HTTP 200 with a byte-identical shell for every OID, so a reader without an account sees no codes. Identical response sizes across different OIDs is the tell; a status check alone passes.

tx.fhir.org renders the same value sets publicly, and it is where the US Core profile pages themselves point this kind of binding. Link text is unchanged.

Page Column Value set
uscdi/care-team.md specialty_nucc Healthcare Provider Taxonomy 2.16.840.1.114222.4.11.1066-20240606
uscdi/care-team.md practitioner_role_code, role_code Care Team Member Function 2.16.840.1.113762.1.4.1099.30-20240605
uscdi/health-insurance.md coverage_type_code Payer Type 2.16.840.1.114222.4.11.3591-20250419
provider-directory/README.md specialty_nucc Healthcare Provider Taxonomy 2.16.840.1.114222.4.11.1066-20240606

Each target verified: HTTP 200, distinct response bodies, status=active, title matching the existing link text. Versions are pinned so the link cannot drift, matching a section already pinned to US Core 6.1.0. Every OID also has an older retired version on tx.fhir.org; the active one is used in all three cases.

@akim1995 two things for you, neither changed here:

  1. This reverses the direction of the closed docs: correct data integration terminology links and codes #45, which proposed adding a VSAC link for sex. If you had a reason to prefer VSAC as the target, say so and I will drop this.
  2. uscdi/patient-demographics.md still links the sex row to the us-core-sex StructureDefinition rather than a code list, which is the defect docs: correct data integration terminology links and codes #45 identified and which never landed. The Sex value set is on tx.fhir.org as 2.16.840.1.113762.1.4.1240.3-20230628, status active. Left alone to keep this change to dead links only.

🤖 Generated with Claude Code

The five VSAC links in the section resolve to a login wall. VSAC serves an
SPA that returns HTTP 200 with a byte-identical shell for every OID, so
the codes are only visible to a reader holding a UMLS account.

tx.fhir.org renders the same value sets publicly. Each link now carries
the pinned version id, the convention the US Core profile pages use for
this kind of binding. Every target verified: HTTP 200, status active,
title matching the existing link text.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@Nesmeshnoy
Nesmeshnoy requested a review from akim1995 August 25, 2026 20:31
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.

1 participant