From 2584ff39f9e4fb557047ddd99ee3e88816a62bb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Moritz=20J=C3=B6rg?= <morjorg@mailbox.org>
Date: Fri, 20 Jun 2025 21:19:57 +0200
Subject: [PATCH] docs: Add basic README

---
 README.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..bbe9639f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# Manifests
+
+Manifest repo managed using [Helmfile](https://github.com/helmfile/helmfile).
+
+Repository structure:
+
+```bash
+/
+├── helmfile.d/                                                 # Helmfiles, *.yaml.gotmpl
+├── charts/                                                     # Our own charts, e.g `Atlantis`
+├── values                                                      # Values for helmfiles
+│   ├── <chart>
+│   │   ├── env.yaml.gotmpl                                     # Values to be templated in `values/`
+│   │   ├── kustomize                                           # Kustomizations per environment
+│   │   ├── manifests                                           # Raw manifests
+│   │   │   ├── <chart>.yaml                                    # Argo App for bootstrap
+│   │   │   ├── dashboards                                      # Grafana dashboards
+│   │   │   │   └── <chart>-metrics.yaml
+│   │   │   └── policies                                        # Cilium and Kyverno policies
+│   │   │       ├── CiliumNetworkPolicy-allow-api-server.yaml   
+│   │   │       └── KyvernoPolicy-regred-secret.yaml            
+│   │   └── values                                              # Values for each environment
+│   │       ├── <chart>-staging.yaml.gotmpl                     # Values for staging environment
+│   │       ├── <chart>-prod.yaml.gotmpl                        # Values for prod environment
+│   │       └── <chart>.yaml.gotmpl                             # Standard values for all environments
+│   │
+│   ├── env.yaml                                             # Standard values for all cluster
+│   ├── env-oceanbox.yaml                                    # Values overrides for oceanbox 
+│   ├── env-ekman.yaml                                       # Values overrides for ekman
+```