Updated project to improve guidance

apps/podinfo/helmrelease.yaml

@@ -1,13 +1,27 @@
+# First app in this repo, deliberately picked because it needs nothing
+# this project builds itself — no CI, no custom image, just a public chart
+# — so a green `flux get kustomization podinfo` here proves the whole
+# source-controller -> helm-controller -> cluster loop works before
+# hello-app adds a CI dependency on top of it.
 apiVersion: helm.toolkit.fluxcd.io/v2
 kind: HelmRelease
 metadata:
   name: podinfo
   namespace: podinfo
 spec:
+  # How often helm-controller re-checks this HelmRelease against the chart
+  # in helmrepository.yaml's cache and re-reconciles if they've drifted —
+  # independent of how often source-controller refreshes that cache (1h,
+  # see helmrepository.yaml).
   interval: 10m
   chart:
     spec:
       chart: podinfo
+      # A range, not a pin: helm-controller installs the latest version
+      # matching this constraint and re-installs on every new matching
+      # release the upstream chart repo publishes. Bump the lower bound by
+      # hand to move the floor forward; there's no CI here to do it
+      # automatically (contrast apps/hello-app's image automation).
       version: ">=6.0.0"
       sourceRef:
         kind: HelmRepository
@@ -17,9 +31,14 @@ spec:
     replicaCount: 1
     ingress:
       enabled: true
+      # k3s ships Traefik as its built-in ingress controller — this is
+      # its IngressClass name, not a choice made by this chart.
       className: traefik
       hosts:
         - host: podinfo.boglabob.com
           paths:
             - path: /
+              # Lets the chart's own Ingress template pick the matching
+              # type for its backend, rather than this repo asserting one
+              # (podinfo's chart uses this instead of a plain "Prefix").
               pathType: ImplementationSpecific