♻️ reorder and document rtx configuration

.rtx.toml

@@ -8,15 +8,15 @@ OTEL_TRACES_SAMPLER = "always_on"
 CLUSTER_NAME = "kind-local"
 
 [tools]
-# docker = '*'  # (or podman + some config) should be available for some of thoses tools
-# dive = '*'    # to explore content of image container
-helm = '3.12'
-# helmfile = '0.155'
-kubectl = '1.27'
-ctlptl = '0.8'
-kind = '0.20'
-java = '*'       # required by skaffold
-skaffold = '2'
+rust = '1.75' # the rust tool stack (with cargo, fmt, clippy) to build source
+just = '1'    # to have a set of simple commands for repetive task (and CI)
 
-rust = '1.75'
-just = '1'
+# local kubernetes (k8s)
+# docker = '*'     # to build, to run containers, should be available for some of thoses tools
+# dive = '*'       # to explore content of image container
+helm = '3.12'    # to deploy, check helm chart
+kubectl = '1.27' # to interact with k8s cluster
+ctlptl = '0.8'   # to setup / manage local k8s (kind) cluster
+kind = '0.20'    # to have a local k8s cluster (on top of docker)
+java = '*'       # required by skaffold
+skaffold = '2'   # to have simple watch flow to build container, to publish container on local k8s registry, to deploy helm chart with new container