diff --git a/k8s/.gitignore b/docs/examples/kubernetes/.gitignore
similarity index 100%
rename from k8s/.gitignore
rename to docs/examples/kubernetes/.gitignore
diff --git a/k8s/README.md b/docs/examples/kubernetes/README.md
similarity index 100%
rename from k8s/README.md
rename to docs/examples/kubernetes/README.md
diff --git a/k8s/base/configmap.yaml b/docs/examples/kubernetes/base/configmap.yaml
similarity index 100%
rename from k8s/base/configmap.yaml
rename to docs/examples/kubernetes/base/configmap.yaml
diff --git a/k8s/base/ingress.yaml b/docs/examples/kubernetes/base/ingress.yaml
similarity index 100%
rename from k8s/base/ingress.yaml
rename to docs/examples/kubernetes/base/ingress.yaml
diff --git a/k8s/base/kustomization.yaml b/docs/examples/kubernetes/base/kustomization.yaml
similarity index 100%
rename from k8s/base/kustomization.yaml
rename to docs/examples/kubernetes/base/kustomization.yaml
diff --git a/k8s/base/service.yaml b/docs/examples/kubernetes/base/service.yaml
similarity index 100%
rename from k8s/base/service.yaml
rename to docs/examples/kubernetes/base/service.yaml
diff --git a/k8s/headscale.bash b/docs/examples/kubernetes/headscale.bash
similarity index 100%
rename from k8s/headscale.bash
rename to docs/examples/kubernetes/headscale.bash
diff --git a/k8s/init.bash b/docs/examples/kubernetes/init.bash
similarity index 100%
rename from k8s/init.bash
rename to docs/examples/kubernetes/init.bash
diff --git a/k8s/install-cert-manager.bash b/docs/examples/kubernetes/install-cert-manager.bash
similarity index 100%
rename from k8s/install-cert-manager.bash
rename to docs/examples/kubernetes/install-cert-manager.bash
diff --git a/k8s/postgres/deployment.yaml b/docs/examples/kubernetes/postgres/deployment.yaml
similarity index 100%
rename from k8s/postgres/deployment.yaml
rename to docs/examples/kubernetes/postgres/deployment.yaml
diff --git a/k8s/postgres/kustomization.yaml b/docs/examples/kubernetes/postgres/kustomization.yaml
similarity index 100%
rename from k8s/postgres/kustomization.yaml
rename to docs/examples/kubernetes/postgres/kustomization.yaml
diff --git a/k8s/postgres/postgres-service.yaml b/docs/examples/kubernetes/postgres/postgres-service.yaml
similarity index 100%
rename from k8s/postgres/postgres-service.yaml
rename to docs/examples/kubernetes/postgres/postgres-service.yaml
diff --git a/k8s/postgres/postgres-statefulset.yaml b/docs/examples/kubernetes/postgres/postgres-statefulset.yaml
similarity index 100%
rename from k8s/postgres/postgres-statefulset.yaml
rename to docs/examples/kubernetes/postgres/postgres-statefulset.yaml
diff --git a/k8s/production-tls/ingress-patch.yaml b/docs/examples/kubernetes/production-tls/ingress-patch.yaml
similarity index 100%
rename from k8s/production-tls/ingress-patch.yaml
rename to docs/examples/kubernetes/production-tls/ingress-patch.yaml
diff --git a/k8s/production-tls/kustomization.yaml b/docs/examples/kubernetes/production-tls/kustomization.yaml
similarity index 100%
rename from k8s/production-tls/kustomization.yaml
rename to docs/examples/kubernetes/production-tls/kustomization.yaml
diff --git a/k8s/production-tls/production-issuer.yaml b/docs/examples/kubernetes/production-tls/production-issuer.yaml
similarity index 100%
rename from k8s/production-tls/production-issuer.yaml
rename to docs/examples/kubernetes/production-tls/production-issuer.yaml
diff --git a/k8s/sqlite/kustomization.yaml b/docs/examples/kubernetes/sqlite/kustomization.yaml
similarity index 100%
rename from k8s/sqlite/kustomization.yaml
rename to docs/examples/kubernetes/sqlite/kustomization.yaml
diff --git a/k8s/sqlite/statefulset.yaml b/docs/examples/kubernetes/sqlite/statefulset.yaml
similarity index 100%
rename from k8s/sqlite/statefulset.yaml
rename to docs/examples/kubernetes/sqlite/statefulset.yaml
diff --git a/k8s/staging-tls/ingress-patch.yaml b/docs/examples/kubernetes/staging-tls/ingress-patch.yaml
similarity index 100%
rename from k8s/staging-tls/ingress-patch.yaml
rename to docs/examples/kubernetes/staging-tls/ingress-patch.yaml
diff --git a/k8s/staging-tls/kustomization.yaml b/docs/examples/kubernetes/staging-tls/kustomization.yaml
similarity index 100%
rename from k8s/staging-tls/kustomization.yaml
rename to docs/examples/kubernetes/staging-tls/kustomization.yaml
diff --git a/k8s/staging-tls/staging-issuer.yaml b/docs/examples/kubernetes/staging-tls/staging-issuer.yaml
similarity index 100%
rename from k8s/staging-tls/staging-issuer.yaml
rename to docs/examples/kubernetes/staging-tls/staging-issuer.yaml