diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 1f74bfc968afbec179b0a1fc6d2ef9e0f0b0837e..2c3de1937fbd0e68f2e04662d5751dea4f129cfc 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -7,6 +7,7 @@ include:
 
 stages:
   - lint
+  - validate
   - test
   - build
   - deploy
@@ -44,6 +45,17 @@ helm_lint:
     - helm dep update .
     - helm lint --strict .
 
+helm_docs_needs_running:
+  stage: validate
+  image: registry.cern.ch/docker.io/jnorwood/helm-docs:v1.14.2
+  rules:
+    - if: '$CI_COMMIT_TAG'
+      when: never
+    - if: $CI_PIPELINE_SOURCE == "push"
+  script:
+    - helm-docs -o test.md
+    - diff -ura test.md README.md
+
 unittest:
   stage: test
   image: registry.cern.ch/docker.io/helmunittest/helm-unittest:3.17.0-0.7.2