Documentation
Guides, technical references, and background on PublicSchema.
Getting Started
Integration Patterns
How PublicSchema works across REST APIs, event-driven systems, verifiable credentials, file exchanges, and analytics pipelines.
Use Cases
Concrete scenarios showing how PublicSchema helps programs coordinate, share data, and reach people across sectors.
Vocabulary Adoption Guide
The lightest integration path: align your system's codes and field values to canonical vocabularies without changing your data model.
Interoperability & Mapping Guide
Using PublicSchema as a Rosetta Stone to map fields and codes between systems, build data exchanges, and consolidate records.
Data Model Design Guide
Using PublicSchema as a reference when designing a new system's data model for interoperability from the start.
JSON-LD & Verifiable Credentials Guide
How to use PublicSchema with JSON-LD contexts, JSON Schema validation, and SD-JWT Verifiable Credentials.
Design Principles
The foundational philosophy behind PublicSchema: semantic not structural, descriptive not prescriptive, evidence-based.
Technical Documentation
Extension Mechanism
Adding custom properties, vocabulary values, and concepts using JSON-LD namespaces.
Selective Disclosure
Privacy design for Verifiable Credentials using SD-JWT.
Versioning and Maturity
Stability guarantees, maturity levels, and URI persistence.
Schema Design
How elements are named, scoped, and modeled. Naming conventions, domain namespacing, and the concept/property/vocabulary decision tree.
Vocabulary Design
Rules for designing controlled vocabularies, referencing standards, and validating through system mappings.
FHIR Mapping Guide
Exchanging PublicSchema disability, functioning, and anthropometric data over FHIR R4: Observation vs. QuestionnaireResponse, LOINC coding, and IPS alignment.