diff --git a/.github/workflows/ah-lint.yaml b/.github/workflows/ah-lint.yaml
index adc05d75..7ca39b76 100644
--- a/.github/workflows/ah-lint.yaml
+++ b/.github/workflows/ah-lint.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: ArtifactHub Lint
 
 # permissions: {}
diff --git a/.github/workflows/check-actions.yaml b/.github/workflows/check-actions.yaml
index 3fb1da97..ec57946b 100644
--- a/.github/workflows/check-actions.yaml
+++ b/.github/workflows/check-actions.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Check actions
 
 # permissions: {}
diff --git a/.github/workflows/codegen.yaml b/.github/workflows/codegen.yaml
index 92633d26..c31b4f5c 100644
--- a/.github/workflows/codegen.yaml
+++ b/.github/workflows/codegen.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Verify codegen
 
 # permissions: {}
diff --git a/.github/workflows/ct-lint.yaml b/.github/workflows/ct-lint.yaml
index 738fb56f..42ca8f0c 100644
--- a/.github/workflows/ct-lint.yaml
+++ b/.github/workflows/ct-lint.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: CT Lint
 
 # permissions: {}
diff --git a/.github/workflows/helm-install.yaml b/.github/workflows/helm-install.yaml
index 01da90ad..01605eb3 100644
--- a/.github/workflows/helm-install.yaml
+++ b/.github/workflows/helm-install.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Helm install
 
 # permissions: {}
diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml
index a3bbf66f..b9405008 100644
--- a/.github/workflows/lint.yaml
+++ b/.github/workflows/lint.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Lint
 
 # permissions: {}
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 20e0ddab..d21a0b08 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Release
 
 on:
diff --git a/.github/workflows/tests.yaml b/.github/workflows/tests.yaml
index 89108f0c..05a06d19 100644
--- a/.github/workflows/tests.yaml
+++ b/.github/workflows/tests.yaml
@@ -1,3 +1,5 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
 name: Tests
 
 # permissions: {}
diff --git a/release-notes/_template.md b/.release-notes/_template.md
similarity index 100%
rename from release-notes/_template.md
rename to .release-notes/_template.md
diff --git a/release-notes/main.md b/.release-notes/main.md
similarity index 100%
rename from release-notes/main.md
rename to .release-notes/main.md
diff --git a/release-notes/v0.0.1.md b/.release-notes/v0.0.1.md
similarity index 100%
rename from release-notes/v0.0.1.md
rename to .release-notes/v0.0.1.md
diff --git a/docs/dev/release/README.md b/docs/dev/release/README.md
index e9e8039d..3529fbc6 100644
--- a/docs/dev/release/README.md
+++ b/docs/dev/release/README.md
@@ -18,8 +18,8 @@ git push origin $TAG
 
 ## Release notes
 
-Release notes for the `main` branch lives in [main.md](../../release-notes/main.md).
+Release notes for the `main` branch lives in [main.md](../../.release-notes/main.md).
 
 Make sure it is up to date and rename the file to the version being released.
 
-You can then copy [_template.md](../../release-notes/_template.md) to [main.md](../../release-notes/main.md) for the next release.
+You can then copy [_template.md](../../.release-notes/_template.md) to [main.md](../../.release-notes/main.md) for the next release.