From edcb76ac05f9a4719d41fe26a9baffb28506669c Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Fri, 1 May 2026 17:46:14 +0800 Subject: [PATCH 1/5] feat: add resources page with migrated content from old website (#3) Migrate reference materials from unitsml.nist.gov including: - Presentations (SCC20, OASIS TC, Santa Fe 2003, Celebi preprint) - Publications (NIST JRES paper, OASIS flyer) - Guidelines & NDRs (UnitsML Guide, Naming and Design Rules) - Archived schema documentation (versions 0.9.2 through 1.0-csd04) - Sample documents and entity relationship model Closes #3 --- .vitepress/config.ts | 2 + resources.md | 391 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 393 insertions(+) create mode 100644 resources.md diff --git a/.vitepress/config.ts b/.vitepress/config.ts index 395b8bb..8ac3555 100644 --- a/.vitepress/config.ts +++ b/.vitepress/config.ts @@ -77,6 +77,7 @@ export default defineConfig({ ] }, { text: 'Software', link: '/software/' }, + { text: 'Resources', link: '/resources' }, { text: 'Blog', link: '/blog/' }, { text: 'About', link: '/about' } ], @@ -111,6 +112,7 @@ export default defineConfig({ items: [ { text: 'Get Started', link: '/get-started' }, { text: 'Schemas', link: '/schemas' }, + { text: 'Reference Materials', link: '/resources' }, ] } ], diff --git a/resources.md b/resources.md new file mode 100644 index 0000000..78ade41 --- /dev/null +++ b/resources.md @@ -0,0 +1,391 @@ +--- +title: Resources +description: Reference materials, presentations, publications, and archived documentation for UnitsML +--- + +# Resources + +
+

+ A collection of presentations, publications, guidelines, and archived schema + documentation from the UnitsML project's 25-year history. +

+
+ + + +## Presentations & Talks + +
+ +
+ +
+
+

IEEE SCC20 / TII-TAD Working Group

+

UnitsML presentation at the IEEE Standards Coordinating Committee 20, Test Information Integration / Test and ATS Description Working Group.

+ September 2011 · PDF / PPT +
+ + + +
+ +
+
+

OASIS TC UnitsML Overview

+

Overview slides from the inaugural OASIS Technical Committee meeting, introducing UnitsML's scope, architecture, and development plan.

+ July 2006 · PDF +
+ + + +
+ +
+
+

Sixth Open Forum on Metadata Registries

+

Early UnitsML presentation at the metadata registries forum in Santa Fe, NM — one of the first public introductions of the project.

+ January 2003 · PPT +
+ + + +
+ +
+
+

UnitsML Preprint (Celebi)

+

Academic preprint covering the design and motivation behind UnitsML for encoding scientific units of measure in XML.

+ PDF +
+ +
+ +## Publications + +
+ +
+ +
+
+

Improving Interoperability by Incorporating UnitsML into Markup Languages

+

Peer-reviewed paper in the NIST Journal of Research describing how UnitsML improves data exchange by embedding unambiguous unit definitions in markup languages.

+ January–February 2010 · NIST JRES · PDF +
+ + + +
+ +
+
+

UnitsML Two-Page Description

+

Concise two-page flyer introducing UnitsML, its purpose, and how it addresses the challenge of encoding scientific units.

+ May 2006 · PDF +
+ +
+ +## Guidelines & Rules + +
+ +
+ +
+
+

Guidelines for the Use of UnitsML

+

Official guidelines document covering how to use UnitsML in practice — writing valid markup, choosing appropriate elements, and incorporating UnitsML into other formats.

+ Version 1.0-wd01 · PDF +
+ + + +
+ +
+
+

Naming and Design Rules (NDRs) for UnitsML 1.0

+

Formal naming and design rules governing the UnitsML XML Schema, ensuring consistency, interoperability, and compliance with standards best practices.

+ Version 1.0 · PDF · Rules only +
+ + + +
+ +
+
+

UnitsML Guidelines Draft v0.4.2

+

Early draft of the UnitsML usage guidelines, providing context on the design decisions and intended usage patterns.

+ Draft 0.4.2 · DOC +
+ +
+ +## Schema Documentation + +The UnitsML XML Schema has evolved through multiple versions. Below are archived documentation and schema files from each release milestone. + +
+
+

Version 1.0-csd04

+ December 2011 +
+ Documentation + Schema (XSD) +
+
+
+

Version 1.0-csd03

+ CSD03 milestone +
+ Documentation + Schema (XSD) +
+
+
+

Version 0.9.19

+ Pre-standardization +
+ Documentation + Schema (XSD) +
+
+
+

Lite 0.9.18

+ Simplified subset +
+ Documentation + Schema (XSD) +
+
+
+

Version 0.9.12

+ Early development +
+ Documentation + Schema (XSD) +
+
+
+

Version 0.9.10

+ Early development +
+ Documentation + Schema (XSD) +
+
+
+

Version 0.9.7

+ Early development +
+ Documentation + Schema (XSD) +
+
+
+

Version 0.9.2

+ Early development +
+ Documentation + Schema (XSD) +
+
+
+ +

See also the schema change log tracking modifications across versions.

+ +## Sample Documents + +
+ +
+ +
+
+

UnitsML Sample Document

+

Example of a concise UnitsML document rendered with an XSLT stylesheet, demonstrating how UnitsML markup looks in practice.

+ HTML +
+ + + +
+ +
+
+

UnitsDB Entity Relationship Model

+

Visual diagram of the UnitsDB data model showing how units, quantities, dimensions, and prefixes relate to each other.

+ ERM diagram +
+ +
+ + From afd82e250b761538482e537c682a0ff86d67d9a8 Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Fri, 1 May 2026 17:47:13 +0800 Subject: [PATCH 2/5] feat: add SciDataCon 2022 Units Summit presentation with video (#8) Add dedicated SciDataCon 2022 section to resources page with: - Embedded YouTube video of the introductory presentation - Summary of topics covered (units problem, UnitsML approach, UnitsDB, governance) Closes #8 --- resources.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/resources.md b/resources.md index 78ade41..2180895 100644 --- a/resources.md +++ b/resources.md @@ -13,6 +13,7 @@ description: Reference materials, presentations, publications, and archived docu +## SciDataCon 2022 — Units Summit + +At the **SciDataCon 2022** "Units Summit" session, a comprehensive introduction to UnitsML was presented, covering the project's history, architecture, and future direction under CalConnect TC UNITS. + +
+
+ +
+
+ +The presentation covered: + +- **The problem of ambiguous units** — why existing approaches (code lists, symbols, names) fail for reliable scientific data exchange +- **UnitsML's approach** — structured models for encoding units, quantities, and dimensions +- **UnitsDB** — the comprehensive database of scientific units, from SI base units to non-SI units +- **Standards governance** — the transition from NIST through OASIS to CalConnect TC UNITS +- **Future directions** — international alignment with ISO, IEC, and BIPM towards a "Digital SI" + ## Presentations & Talks
@@ -379,6 +406,31 @@ The UnitsML XML Schema has evolved through multiple versions. Below are archived text-decoration: underline; } +/* Video embed */ +.video-embed { + margin: 1.5rem 0 2rem; +} + +.video-wrapper { + position: relative; + width: 100%; + max-width: 720px; + padding-bottom: 56.25%; + border-radius: 12px; + overflow: hidden; + background: var(--vp-c-bg-soft); + border: 1px solid var(--vp-c-divider); +} + +.video-wrapper iframe { + position: absolute; + top: 0; + left: 0; + width: 100%; + height: 100%; + border: none; +} + @media (max-width: 640px) { .resource-grid { grid-template-columns: 1fr; From db262759f168c9b44aaba08122e5056cea8f800e Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Fri, 1 May 2026 17:48:38 +0800 Subject: [PATCH 3/5] feat: add UnitsML introduction video reference (#9) Add video callout to 'What is UnitsML' page linking to the SciDataCon 2022 introductory video on YouTube. Also referenced from the resources page. Closes #9 --- learn/what-is-unitsml.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/learn/what-is-unitsml.md b/learn/what-is-unitsml.md index c53926e..5370b48 100644 --- a/learn/what-is-unitsml.md +++ b/learn/what-is-unitsml.md @@ -208,6 +208,16 @@ UnitsML was originally hosted at `unitsml.nist.gov`. An OASIS Technical Committe ## Next steps +
+
+ +
+
+ Watch the introduction — a video overview from SciDataCon 2022 covers UnitsML's history, architecture, and future direction: + UnitsML Introduction on YouTube → +
+
+ - [Who is UnitsML for?](/learn/who-is-it-for) — understand the target audiences and use cases - [How UnitsML works](/learn/how-it-works) — dive into the technical architecture - [Incorporating UnitsML](/learn/incorporating-unitsml) — learn how to add UnitsML to your XML formats @@ -287,4 +297,29 @@ UnitsML was originally hosted at `unitsml.nist.gov`. An OASIS Technical Committe grid-template-columns: 1fr; } } + +.video-callout { + display: flex; + gap: 0.75rem; + align-items: flex-start; + padding: 1rem 1.25rem; + margin-bottom: 1.5rem; + background: var(--vp-c-bg-soft); + border: 1px solid var(--vp-c-divider); + border-radius: 12px; + font-size: 0.875rem; + line-height: 1.6; + color: var(--vp-c-text-2); +} + +.video-callout-icon { + color: var(--vp-c-brand-1); + flex-shrink: 0; + display: flex; + padding-top: 0.125rem; +} + +.video-callout strong { + color: var(--vp-c-text-1); +} From d9de70b9bece4a566dd5544fe6e75b48831b483e Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Fri, 1 May 2026 17:50:49 +0800 Subject: [PATCH 4/5] feat: add supporters page with detailed organization profiles (#4) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Create dedicated supporters page with detailed profiles of organizations that have contributed to UnitsML's development: - NIST (originator, 1998–present) - CalConnect (current standards body, 2022–present) - LBNL, Ribose, IBM, CML (contributors) - OASIS (former standards body, 2006–2016) - BIPM (advisory role, Digital SI alignment) Also adds Supporters link to about page and sidebar navigation. Closes #4 --- .vitepress/config.ts | 12 +++ about.md | 22 ++++- supporters.md | 200 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 233 insertions(+), 1 deletion(-) create mode 100644 supporters.md diff --git a/.vitepress/config.ts b/.vitepress/config.ts index 8ac3555..b60463a 100644 --- a/.vitepress/config.ts +++ b/.vitepress/config.ts @@ -150,6 +150,18 @@ export default defineConfig({ text: 'About', items: [ { text: 'About UnitsML', link: '/about' }, + { text: 'Supporters', link: '/supporters' }, + { text: 'Privacy Policy', link: '/privacy' }, + { text: 'Terms of Service', link: '/tos' }, + ] + } + ], + '/supporters': [ + { + text: 'About', + items: [ + { text: 'About UnitsML', link: '/about' }, + { text: 'Supporters', link: '/supporters' }, { text: 'Privacy Policy', link: '/privacy' }, { text: 'Terms of Service', link: '/tos' }, ] diff --git a/about.md b/about.md index a965ea8..f141409 100644 --- a/about.md +++ b/about.md @@ -20,6 +20,7 @@ UnitsML is under active development and its documentation may change frequently. History People Organizations + Supporters FAQ @@ -98,6 +99,10 @@ UnitsML has been shaped by contributors across government, academia, and industr ## Participating Organizations +
+ See all supporters with details → +
+