Yolean · solsson · Jul 22, 2026 · Jul 22, 2026 · Jul 22, 2026 · Jul 22, 2026
diff --git a/.github/workflows/e2e.yaml b/.github/workflows/e2e.yaml
@@ -37,6 +37,12 @@ jobs:
         go vet ./...
         go test ./...
 
+    - name: Assert generated CR schemas are committed
+      run: |
+        set -euxo pipefail
+        go run ./scripts/gen-cr-schemas
+        git diff --exit-code -- schema/
+
     - name: Install k3d, kubectl, crane, yq
       run: |
         set -euxo pipefail

diff --git a/SPEC.md b/SPEC.md
@@ -561,11 +561,27 @@ Each schema lives in the operator repo under
 `pkg/drivers/<driver>/schema/<major.minor>/*.schema.json` and is
 published via the GitHub raw URL (this is the publication
 mechanism — there's no separate registry). Versioning is the
-driver SemVer (see *Driver versioning*). Example YAMLs (in this
-repo and in consumer ystack) carry
-`# yaml-language-server: $schema=...` annotations pointing at
-the raw URL so editors validate before kubectl ever sees the
-file.
+driver SemVer (see *Driver versioning*). The object-store family
+publishes its family-common parameters the same way, under
+`pkg/drivers/objectstore/schema/`.
+
+On top of these, `schema/` at the repo root carries GENERATED
+standalone whole-document schemas for editors (the
+kubernetes-json-schema pattern): `buckety.schema.json` plus one
+per family and per driver (`buckety-blobstore` for the
+object-store family, `buckety-gcs`, `buckety-s3`,
+`buckety-kadm`) and `bucketyaccess.schema.json`.
+The suffix forms a specialize/generalize ladder walked by
+switching the URL: the family rung accepts only family-common
+parameters, so a resource annotated with it provably stays
+portable across bucket backends. `go run ./scripts/gen-cr-schemas`
+composes them from the CRD yamls and the parameters schemas; CI
+asserts the output is committed. Example YAMLs (in this repo and
+in consumer ystack) carry `# yaml-language-server: $schema=...`
+annotations pointing at the raw URL so editors validate before
+kubectl ever sees the file. Editor schemas are advisory: the
+admission webhook stays the authority, validating against the
+backend the CR names rather than the schema the file claims.
 
 ## Mutability
 

diff --git a/examples/gcs/adoption/fresh.yaml b/examples/gcs/adoption/fresh.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/adoption/pre.yaml b/examples/gcs/adoption/pre.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 # Collides with the pre-created, content-holding resource; the
 # default adoption policy (AdoptEmpty) must refuse it.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/gcs/adoption/void.yaml b/examples/gcs/adoption/void.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 # Collides with the pre-created EMPTY resource; AdoptEmpty (the
 # default) adopts it silently.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/gcs/backend-stickiness/original.yaml b/examples/gcs/backend-stickiness/original.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/backend-stickiness/renamed.yaml b/examples/gcs/backend-stickiness/renamed.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/happy-path/buckety.yaml b/examples/gcs/happy-path/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/multi-consumer/access.yaml b/examples/gcs/multi-consumer/access.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/gcs/multi-consumer/buckety.yaml b/examples/gcs/multi-consumer/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/naming-templates/bad-name.yaml b/examples/gcs/naming-templates/bad-name.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/naming-templates/bad-template.yaml b/examples/gcs/naming-templates/bad-template.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/naming-templates/buckety.yaml b/examples/gcs/naming-templates/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/oob-drift/buckety.yaml b/examples/gcs/oob-drift/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/parameter-mutation/buckety.yaml b/examples/gcs/parameter-mutation/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/portable-blobs-cr/buckety.yaml b/examples/gcs/portable-blobs-cr/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-blobstore.schema.json
 # One CR for any bucket-family backend (SPEC "Driver families").
 # Everything in spec is family-common and the backend name
 # "objects" is use-case-named, not driver-named; this file is

diff --git a/examples/gcs/retention-policy/buckety.yaml b/examples/gcs/retention-policy/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/gcs/scaled-to-zero/buckety.yaml b/examples/gcs/scaled-to-zero/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-gcs.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/access-migration/buckety-initial.yaml b/examples/kadm/access-migration/buckety-initial.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/access-migration/migrated/access-explicit.yaml b/examples/kadm/access-migration/migrated/access-explicit.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/kadm/access-migration/migrated/buckety.yaml b/examples/kadm/access-migration/migrated/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/adoption/fresh.yaml b/examples/kadm/adoption/fresh.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/adoption/pre.yaml b/examples/kadm/adoption/pre.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 # Collides with the pre-created, content-holding resource; the
 # default adoption policy (AdoptEmpty) must refuse it.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/kadm/adoption/void.yaml b/examples/kadm/adoption/void.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 # Collides with the pre-created EMPTY resource; AdoptEmpty (the
 # default) adopts it silently.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/kadm/backend-stickiness/original.yaml b/examples/kadm/backend-stickiness/original.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/backend-stickiness/renamed.yaml b/examples/kadm/backend-stickiness/renamed.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/driver-version/buckety.yaml b/examples/kadm/driver-version/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/happy-path/buckety.yaml b/examples/kadm/happy-path/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/multi-consumer/access.yaml b/examples/kadm/multi-consumer/access.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/kadm/multi-consumer/buckety.yaml b/examples/kadm/multi-consumer/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/naming-templates/bad-template.yaml b/examples/kadm/naming-templates/bad-template.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/naming-templates/buckety.yaml b/examples/kadm/naming-templates/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/oob-drift/buckety.yaml b/examples/kadm/oob-drift/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/parameter-mutation/buckety.yaml b/examples/kadm/parameter-mutation/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/retention-policy/buckety.yaml b/examples/kadm/retention-policy/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/scaled-to-zero/buckety.yaml b/examples/kadm/scaled-to-zero/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/secret-conflict/access.yaml b/examples/kadm/secret-conflict/access.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/kadm/secret-conflict/buckety.yaml b/examples/kadm/secret-conflict/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-kadm.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/webhook-fallback-validation/base.yaml b/examples/kadm/webhook-fallback-validation/base.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/webhook-fallback-validation/invalid-access.yaml b/examples/kadm/webhook-fallback-validation/invalid-access.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/kadm/webhook-fallback-validation/invalid-params.yaml b/examples/kadm/webhook-fallback-validation/invalid-params.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/kadm/webhook-fallback-validation/resume-probe.yaml b/examples/kadm/webhook-fallback-validation/resume-probe.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/adoption/fresh.yaml b/examples/s3/adoption/fresh.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/adoption/pre.yaml b/examples/s3/adoption/pre.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 # Collides with the pre-created, content-holding resource; the
 # default adoption policy (AdoptEmpty) must refuse it.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/s3/adoption/void.yaml b/examples/s3/adoption/void.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 # Collides with the pre-created EMPTY resource; AdoptEmpty (the
 # default) adopts it silently.
 apiVersion: buckety.yolean.se/v1alpha1

diff --git a/examples/s3/backend-stickiness/original.yaml b/examples/s3/backend-stickiness/original.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/backend-stickiness/renamed.yaml b/examples/s3/backend-stickiness/renamed.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/driver-version/buckety.yaml b/examples/s3/driver-version/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/happy-path/buckety.yaml b/examples/s3/happy-path/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/jurisdiction-gating/accepted.yaml b/examples/s3/jurisdiction-gating/accepted.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/jurisdiction-gating/rejected-on-non-r2.yaml b/examples/s3/jurisdiction-gating/rejected-on-non-r2.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/multi-consumer/access.yaml b/examples/s3/multi-consumer/access.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/bucketyaccess.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: BucketyAccess
 metadata:

diff --git a/examples/s3/multi-consumer/buckety.yaml b/examples/s3/multi-consumer/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/naming-templates/bad-name.yaml b/examples/s3/naming-templates/bad-name.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/naming-templates/bad-template.yaml b/examples/s3/naming-templates/bad-template.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/naming-templates/buckety.yaml b/examples/s3/naming-templates/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/oob-drift/buckety.yaml b/examples/s3/oob-drift/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/parameter-mutation/buckety.yaml b/examples/s3/parameter-mutation/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/portable-blobs-cr/buckety.yaml b/examples/s3/portable-blobs-cr/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-blobstore.schema.json
 # One CR for any bucket-family backend (SPEC "Driver families").
 # Everything in spec is family-common and the backend name
 # "objects" is use-case-named, not driver-named; this file is

diff --git a/examples/s3/retention-policy/buckety.yaml b/examples/s3/retention-policy/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata:

diff --git a/examples/s3/scaled-to-zero/buckety.yaml b/examples/s3/scaled-to-zero/buckety.yaml
@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/Yolean/buckety-controller/main/schema/buckety-s3.schema.json
 apiVersion: buckety.yolean.se/v1alpha1
 kind: Buckety
 metadata: