docs: add choice (#20139)

Author: naltatis

templates/definition/meter/sonnenbatterie.yaml

@@ -36,8 +36,8 @@ params:
     default: self-consumption
     advanced: true
     help:
-      de: Standardmodus für die aktive Batteriesteuerung (self-consumption oder time-of-use)
-      en: Default mode for active battery control (self-consumption or time-of-use)
+      de: Standardmodus für die aktive Batteriesteuerung
+      en: Default mode for active battery control
     usages: ["battery"]
   - name: chargepower
     default: 3300

util/templates/documentation.tpl

@@ -4,7 +4,14 @@
   - {{ . }}
   {{- end }}
   {{- $help := localize .Help | replace "\n" " " -}}
-  {{- if $help }} # {{ $help }}{{- end }}{{- if not .IsRequired }}{{ if not $help }} # {{ else }} ({{ end }}optional{{ if $help }}){{ end }}{{ end }}
+  {{- $choices := join ", " .Choice -}}
+  {{- $optional := not .IsRequired -}}
+  {{- if or $help $choices $optional }} # {{end}}
+  {{- if $help }}{{ $help }} {{end}}
+  {{- if $choices }}[{{ $choices }}] {{end}}
+  {{- if $optional }}
+    {{- if or $help  $choices }}(optional){{ else }}optional{{end }}
+  {{- end }}
 {{- end }}
 
 {{- define "header" }}