update data protocol links to be version agnostic in docs (#29)

clevinson · web-flow · commit bc65802b7de7 · 2026-04-21T10:40:17.000-07:00
diff --git a/src/docs/files/getting-started/index.md b/src/docs/files/getting-started/index.md
@@ -2,15 +2,16 @@
 
 ## The OAE Data Protocol
 
-The [OAE Data Management Protocol](https://www.carbontosea.org/oae-data-protocol/1-0-0/) is a set of guidelines for collecting, documenting, and sharing data from ocean alkalinity enhancement research. It covers:
+The [OAE Data Management Protocol](https://www.carbontosea.org/oae-data-protocol) is a set of guidelines for
+collecting, documenting, and sharing data from ocean alkalinity enhancement research. It covers:
 
 - What metadata to include with your data submissions
 - Recommended column header names for data files
 - Controlled vocabularies for consistent terminology
 - Guidelines for quality control documentation
 
 !!! info "New to the OAE Data Protocol?"
-    If you're new to the protocol and want to learn about its guidelines and recommendations before diving into the technical schema, start with the [protocol website](https://www.carbontosea.org/oae-data-protocol/1-0-0/) on Carbon To Sea. It includes the full guidelines, [controlled vocabularies](https://www.carbontosea.org/oae-data-protocol/1-0-0/#controlled-vocabularies), and [recommended column header names](https://www.carbontosea.org/oae-data-protocol/1-0-0/#column-header-name).
+    If you're new to the protocol and want to learn about its guidelines and recommendations before diving into the technical schema, start with the [protocol website](https://www.carbontosea.org/oae-data-protocol) on Carbon To Sea. It includes the full guidelines, [controlled vocabularies](https://www.carbontosea.org/oae-data-protocol#controlled-vocabularies), and [recommended column header names](https://www.carbontosea.org/oae-data-protocol#column-header-names).
 
 ## The OAE Data Schema
 
diff --git a/src/docs/files/index.md b/src/docs/files/index.md
@@ -1,7 +1,7 @@
 # Schema Documentation
 
-The [OAE Data Management Protocol](https://www.carbontosea.org/oae-data-protocol/1-0-0/) outlines recommendations for
-producing consistent data and metadata across Ocean Alkalinity Enhancement research projects, developed by [Carbon To Sea](https://carbontosea.org) and [Submarine Scientific](https://submarine.earth) in collaboration with NOAA and the broader OAE community.
+The [OAE Data Management Protocol](https://www.carbontosea.org/oae-data-protocol) outlines recommendations for
+producing consistent data and metadata across Ocean Alkalinity Enhancement projects, developed by [Carbon To Sea](https://carbontosea.org) and [Submarine Scientific](https://submarine.earth) in collaboration with NOAA and the broader OAE community.
 
 This site serves as the technical documentation for the machine-readable schemas that turn those recommendations into something software systems can validate and exchange.
 
@@ -20,11 +20,11 @@ The OAE Data Protocol is a structured approach to collecting, documenting, and s
 - **Variables** — Measured, calculated, and contextual variables with instrument and calibration metadata
 
 For protocol requirements pertaining to general metadata management, excel metadata templates, dataset formatting, and
-column header names, see the [published protocol](https://www.carbontosea.org/oae-data-protocol/1-0-0/).
+column header names, see the [published protocol](https://www.carbontosea.org/oae-data-protocol).
 
 
 ### Published Artifacts & Resources
-- [OAE Metadata Builder](https://github.com/submarine-mrv/oae-metadata-builder) — Web app for creating and managing JSON metadata files
+- [OAE Metadata Builder](https://metadata.oaedata.org) — Web app for creating and managing JSON metadata files
 - [JSON Schema](https://github.com/submarine-mrv/oae-data-protocol/blob/main/project/jsonschema/oae_data_protocol.schema.json) — Machine readable schemas used for validation
 - [LinkML Source Schema](https://github.com/submarine-mrv/oae-data-protocol/tree/main/src/oae_data_protocol/schema) — The source of truth for generating all schema artifacts and documentation (contributors should only edit these files)
 - [Python Dataclasses](https://github.com/submarine-mrv/oae-data-protocol/blob/main/src/oae_data_protocol/datamodel/oae_data_protocol.py) — For managing metadata directly in Python workflows (WIP)
diff --git a/src/docs/files/metadata-format.md b/src/docs/files/metadata-format.md
@@ -4,7 +4,7 @@ The OAE Data Protocol uses **JSON** as its preferred metadata file format.
 
 Each metadata file is a self-contained document called a **Container** that holds all the metadata for a project, its experiments, and its datasets.
 
-The recommended way to create metadata is with the **[OAE Metadata Builder](https://metadata.oaedata.org)**, which validates inputs against the schema in real time and exports well-formed JSON files. While [Excel templates](https://www.carbontosea.org/oae-data-protocol/1-0-0/#metadata-and-templates) are still available on the protocol website, they do not validate against the schema and require manual attention to ensure controlled vocabularies and field formats are correct. We encourage all researchers to use the Metadata Builder as the primary tool for creating and managing project metadata.
+The recommended way to create metadata is with the **[OAE Metadata Builder](https://metadata.oaedata.org)**, which validates inputs against the schema in real time and exports well-formed JSON files. While [Excel templates](https://www.carbontosea.org/oae-data-protocol#metadata-and-templates) are still available on the protocol website, they do not validate against the schema and require manual attention to ensure controlled vocabularies and field formats are correct. We encourage all researchers to use the Metadata Builder as the primary tool for creating and managing project metadata.
 
 ## The Container
 
diff --git a/src/docs/files/vocabularies.md b/src/docs/files/vocabularies.md
@@ -2,7 +2,7 @@
 
 The OAE Data Protocol uses controlled vocabularies to standardize categorical values across metadata submissions. Some are defined as part of the protocol, while others reference established community standards.
 
-For detailed definitions of each vocabulary, see the [Controlled Vocabularies](https://www.carbontosea.org/oae-data-protocol/1-0-0/#controlled-vocabularies) section of the OAE Data Protocol website.
+For detailed definitions of each vocabulary, see the [Controlled Vocabularies](https://www.carbontosea.org/oae-data-protocol#controlled-vocabularies) section of the OAE Data Protocol website.
 
 ## Community Standard Vocabularies
 
@@ -11,13 +11,13 @@ The following vocabularies are sourced from established oceanographic & scientif
 | Vocabulary | Source                                                                                                                                                                                     | Used For |
 |-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
 | **Sea Names** | NERC [SDN:C16](https://vocab.nerc.ac.uk/collection/C16/current/)                                                                                                                           | Project geographic classification |
-| **[Platform Type](https://www.carbontosea.org/oae-data-protocol/1-0-0/#platform-type)** | NERC [SDN:L06](https://vocab.nerc.ac.uk/collection/L06/current/)                                                                                                                           | Dataset platform classification |
-| **[Instrument Type](https://www.carbontosea.org/oae-data-protocol/1-0-0/#instrument-type)** | NERC [SDN:L05](https://vocab.nerc.ac.uk/collection/L05/current/), [SDN:L22](https://vocab.nerc.ac.uk/collection/L22/current/), [SDN:B75](https://vocab.nerc.ac.uk/collection/B75/current/) | Sampling and analyzing instruments |
+| **[Platform Type](https://www.carbontosea.org/oae-data-protocol#platform-type)** | NERC [SDN:L06](https://vocab.nerc.ac.uk/collection/L06/current/)                                                                                                                           | Dataset platform classification |
+| **[Instrument Type](https://www.carbontosea.org/oae-data-protocol#instrument-type)** | NERC [SDN:L05](https://vocab.nerc.ac.uk/collection/L05/current/), [SDN:L22](https://vocab.nerc.ac.uk/collection/L22/current/), [SDN:B75](https://vocab.nerc.ac.uk/collection/B75/current/) | Sampling and analyzing instruments |
 | **Units** | [QUDT](https://qudt.org/vocab/unit/)                                                                                                                                                       | Dosing concentration units |
 
 ## OAE Data Protocol Vocabularies
 
-These vocabularies are defined as part of the [OAE Data Protocol](https://www.carbontosea.org/oae-data-protocol/1-0-0/#controlled-vocabularies) and maintained in this schema.
+These vocabularies are defined as part of the [OAE Data Protocol](https://www.carbontosea.org/oae-data-protocol#controlled-vocabularies) and maintained in this schema.
 
 ### Classification
 
