You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- **Pre-stable:** full SemVer in path (`/v0.1.0/`)
150
150
- **Post-1.0.0:** switch to major-only paths (`/v1/`) with permanent redirects from historical full-SemVer URLs
151
151
- **Hosting:** TBD (GitHub Pages on a dedicated repo, or static-hosted redirect to raw GitHub content). Must be HTTPS, stable, `Content-Type: application/schema+json`.
@@ -155,7 +155,7 @@ Meta-schema encodes this via `allOf` with 4 `if/then` branches keyed on `type`.
@@ -191,7 +191,7 @@ Meta-schema encodes this via `allOf` with 4 `if/then` branches keyed on `type`.
191
191
192
192
### Phase C — Publishing
193
193
194
-
- #125 — Host meta-schema at `https://schemas.opendecree.io/schema/v0.1.0/decree.json`
194
+
- #125 — Host meta-schema at `https://schemas.opendecree.dev/schema/v0.1.0/decree.json`
195
195
- #126 — Submit schemastore.org PR
196
196
197
197
### Phase D — Docs
@@ -205,7 +205,7 @@ Meta-schema encodes this via `allOf` with 4 `if/then` branches keyed on `type`.
205
205
206
206
## Open questions
207
207
208
-
- **Hosting target for `schemas.opendecree.io`** — dedicated GitHub Pages repo? Cloudflare redirect to raw GitHub content? Needs DNS + CORS setup.
208
+
- **Hosting target for `schemas.opendecree.dev`** — dedicated GitHub Pages repo? Cloudflare redirect to raw GitHub content? Needs DNS + CORS setup.
209
209
- **Bundling tool** — hand-rolled Python script vs off-the-shelf (e.g. `json-dereference-cli`). Go with off-the-shelf if one exists and is maintained.
210
210
- **Does the CLI emit `$schema`/`$id` on export?** — `decree schema export` should probably inject `$schema` by default, make `$id` opt-in.
211
211
- **Post-v1.0.0 URL migration** — when the spec promotes to 1.0.0, keep `/v0.1.0/` live forever or redirect? Preserve forever matches OpenAPI's dated-URL practice.
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -336,8 +336,8 @@ Values use a `TypedValue` oneof — integer, number, string, bool, timestamp, du
336
336
337
337
The schema YAML format authors write to define their config shape is documented in [Schema Format](docs/concepts/schema-format.md). The corresponding [JSON Schema 2020-12 meta-schemas](docs/concepts/meta-schema.md) for editor IntelliSense and CI validation are published at:
All endpoints that accept a tenant or schema ID also accept the **name slug** — the server resolves automatically. Use UUIDs or human-readable names interchangeably:
Copy file name to clipboardExpand all lines: docs/concepts/meta-schema.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,7 +45,7 @@ YAML is the human-edited source of truth. JSON copies are generated by [`scripts
45
45
Add the modeline on line 1 of your schema or config file. VS Code, Neovim, IntelliJ, Helix, and Zed via [yaml-language-server](https://github.com/redhat-developer/yaml-language-server) auto-apply the schema for autocompletion and inline error highlighting:
**Pre-stable (current):** full SemVer in the path — `https://schemas.opendecree.io/schema/v0.1.0/...`. Each release of the meta-schema is published at its exact version path forever; older versions stay reachable for tools that pin a specific version.
98
+
**Pre-stable (current):** full SemVer in the path — `https://schemas.opendecree.dev/schema/v0.1.0/...`. Each release of the meta-schema is published at its exact version path forever; older versions stay reachable for tools that pin a specific version.
99
99
100
100
**Post-1.0.0 (future):** switch to major-only paths (`/v1/`) with permanent redirects from historical full-SemVer URLs. Matches the OpenAPI 3.x dated-URL practice.
Copy file name to clipboardExpand all lines: docs/concepts/schema-format.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,18 +14,18 @@ The canonical reference for the **decree.schema.yaml** format — every top-leve
14
14
Place the modeline on line 1 of every file so editors with [yaml-language-server](https://github.com/redhat-developer/yaml-language-server) auto-apply schema validation and IntelliSense:
A schema defines the structure of your configuration — what fields exist, their types, and constraints. Create a file called `decree.schema.yaml` (or `<name>.decree.schema.yaml` if your repo holds multiple schemas):
"description": "Tenant-side import format for OpenDecree config values. A decree.config.yaml file declares the values to apply against a previously imported schema; the server enforces type compatibility and cross-field rules at write time.",
0 commit comments