Update docs and chart metadata

Author: NobodysNightmare

charts/openproject-id/Chart.yaml

@@ -14,4 +14,5 @@ maintainers:
 - name: OpenProject
   url: https://github.com/opf/
 name: openproject-id
+description: Configures a Keycloak like we use it for OpenProject ID.
 version: 0.1.2

charts/openproject-id/README.md

@@ -6,24 +6,28 @@ The intention is to have templates that are easier to read, while giving us flex
 
 ## Configuration
 
+### Development
+
 The defaults in the helm chart should be working right away on a development cluster (e.g. minikube):
 
-```
+```bash
 helm upgrade --install keycloak .
 ```
 
-On a production system you want to:
-
-* disable the postgres dependency (because we want to run the database in a managed service like RDS)
-* disable generation of secrets, because we usually seed these externally, e.g. via Terraform
-* Customize the remaining values (e.g. adding annotations)
+### Production
 
-On production add the repo like so.
+Make sure that the corresponding Helm repository is configured:
 
 ```bash
 helm repo add openproject-id https://opf.github.io/openproject-id/
 ```
 
+Configuration-wise you want to:
+
+* disable the postgres dependency (because we want to run the database in a managed service like RDS)
+* disable generation of secrets, because we usually seed these externally, e.g. via Terraform
+* Customize the remaining values (e.g. adding annotations)
+
 An example values.yaml for your production environment might look like this:
 
 ```yaml