documenting KMM configuration persistent during upgrade feature

Adjusting the docs following the new feature in KMM which configuration can be persistent during upgrade

Author: TomerNewman

docs/mkdocs/documentation/configure.md

@@ -1,46 +1,64 @@
 # Configuring
 
-KMM should be configured out of the box with sensible defaults.
-The operator configuration is set in the `kmm-operator-manager-config` `ConfigMap` in the operator namespace.
-To modify any setting, edit the `ConfigMap` data and restart the controller with the following command:
+KMM is configured out of the box with sensible defaults.
+To modify any setting, create a `ConfigMap` with name of `kmm-operator-manager-config` in the operator namespace with 
+the relevant data and restart the controller with the following command:
 
 ```shell
 kubectl delete pod -n "$namespace" -l app.kubernetes.io/component=kmm
 ```
 
 The value of `$namespace` depends on your [installation method](install.md).
 
+## Example
+```yaml
+apiVersion: v1
+data:
+  controller_config.yaml: |
+    worker:
+      firmwareHostPath: /example/different/firmware/path
+kind: ConfigMap
+metadata:
+  name: kmm-operator-manager-config
+  namespace: kmm-operator-system
+```
+
+### Note
+If you want to configure `KMM Hub`, then create the `ConfigMap` with the name `kmm-operator-hub-manager-config` instead
+in the KMM-hub controller's namespace.
+
+
 ## Reference
 
 #### `healthProbeBindAddress`
 
 Defines the address on which the operator should listen for kubelet health probes.  
-Recommended value: `:8081`.
+Default value: `:8081`.
 
 #### `job.gcDelay`
 
 Defines the duration for which successful build pods should be preserved before they are deleted.  
 Refer to the Go [`ParseDuration`](https://pkg.go.dev/time#ParseDuration) function documentation to understand valid
 values for this setting.  
-There is no recommended value for this setting.
+Default value: `0`.
 
 #### `leaderElection.enabled`
 
 Determines whether [leader election](https://kubernetes.io/docs/concepts/architecture/leases/) is used to ensure that
 only one replica of the KMM operator is running at any time.  
-Recommended value: `true`.
+Default value: `true`.
 
 #### `leaderElection.resourceID`
 
 Determines the name of the resource that leader election will use for holding the leader lock.  
-Recommended value: `kmm.sigs.x-k8s.io`.
+Default value: `kmm.sigs.x-k8s.io` for KMM and `kmm-hub.sigs.x-k8s.io` for KMM-hub.
 
 #### `metrics.bindAddress`
 
 Determines the bind address for the metrics server.
 It will be defaulted to `:8080` if unspecified.
 Set this to "0" to disable the metrics server.  
-Recommended value: `0.0.0.0:8443`.
+Default value: `0.0.0.0:8443`.
 
 #### `metrics.enableAuthnAuthz`
 
@@ -55,33 +73,33 @@ To scrape metrics e.g. via Prometheus the client needs a `ClusterRole` with the
 
   - `nonResourceURLs: "/metrics", verbs: get`
 
-Recommended value: `true`.
+Default value: `true`.
 
 #### `metrics.secureServing`
 
 Determines whether the metrics should be served over HTTPS instead of HTTP.  
-Recommended value: `true`.
+Default value: `true`.
 
 #### `webhookPort`
 
 Defines the port on which the operator should be listening for webhook requests.  
-Recommended value: `9443`.
+Default value: `9443`.
 
 #### `worker.runAsUser`
 
 Determines the value of the `runAsUser` field of the worker container's
 [SecurityContext](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/).  
-Recommended value: `9443`.
+Default value: `0`.
 
 #### `worker.seLinuxType`
 
 Determines the value of the `seLinuxOptions.type` field of the worker container's
 [SecurityContext](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/).  
-Recommended value: `spc_t`.
+Default value: `spc_t`.
 
 #### `worker.firmwareHostPath`
 
 If set, the value of this field will be written by the worker into the `/sys/module/firmware_class/parameters/path` file
 on the node.
 This sets the [kernel's firmware search path](firmwares.md#setting-the-kernels-firmware-search-path).  
-Recommended value: `/lib/firmware` if you need to set that value through the worker app; otherwise, unset.
+Default value: `/lib/firmware`.