Merge branch 'patch-237' into 'master'

Update Code-Quality.gitlab-ci.yml to propogate REPORT_FORMAT variable

See merge request gitlab-org/gitlab!42781

doc/user/project/merge_requests/code_quality.md

@@ -265,6 +265,25 @@ Once the Code Quality job has completed:
   [downloadable artifact](../../../ci/pipelines/job_artifacts.md#downloading-artifacts)
   for the `code_quality` job.
 
+### Generating an HTML report
+
+In [GitLab 13.6 and later](https://gitlab.com/gitlab-org/ci-cd/codequality/-/issues/10),
+it is possible to generate an HTML report file by setting the `REPORT_FORMAT`
+variable to `html`. This is useful if you just want to view the report in a more
+human-readable format or to publish this artifact on GitLab Pages for even
+easier reviewing.
+
+```yaml
+include:
+  - template: Code-Quality.gitlab-ci.yml
+
+code_quality:
+  variables:
+    REPORT_FORMAT: html
+  artifacts:
+    paths: [gl-code-quality-report.html]
+```
+
 ## Extending functionality
 
 ### Using Analysis Plugins

lib/gitlab/ci/templates/Jobs/Code-Quality.gitlab-ci.yml

@@ -34,6 +34,7 @@ code_quality:
           CODECLIMATE_DEBUG \
           CODECLIMATE_DEV \
           REPORT_STDOUT \
+          REPORT_FORMAT \
           ENGINE_MEMORY_LIMIT_BYTES \
         ) \
         --volume "$PWD":/code \