feat(helm): Better explanation for failing GHA (#13198)

Author: kiblik

.github/workflows/test-helm-chart.yml

@@ -80,7 +80,9 @@ jobs:
       - name: Checkout
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
 
-      # If this step is failing, run `helm-docs --chart-search-root helm/defectdojo`
+      # Documentation provided in the README file needs to contain the latest information from `values.yaml` and all other related assets.
+      # If this step fails, install https://github.com/norwoodj/helm-docs and run locally `helm-docs --chart-search-root helm/defectdojo` before committing your changes.
+      # The helm-docs documentation will be generated for you.
       - name: Run helm-docs
         uses: losisin/helm-docs-github-action@a57fae5676e4c55a228ea654a1bcaec8dd3cf5b5 # v1.6.2
         with:
@@ -94,7 +96,10 @@ jobs:
       - name: Checkout
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
 
-      # If this step is failing, run `helm schema --use-helm-docs` in `helm/defectdojo`
+      # The HELM structure supports the existence of a `values.schema.json` file. This file is used to validate all values provided by the user before Helm starts rendering templates.
+      # The chart needs to have a `values.schema.json` file that is compatible with the default `values.yaml` file.
+      # If this step fails, install https://github.com/losisin/helm-values-schema-json and run locally `helm schema --use-helm-docs` in `helm/defectdojo` before committing your changes.
+      # The helm schema will be generated for you.
       - name: Generate values schema json
         uses: losisin/helm-values-schema-json-action@d5847286fa04322702c4f8d45031974798c83ac7 # v2.3.0
         with: