Add latest changes from gitlab-org/gitlab@master

2 files changed, 12 insertions, 0 deletions

diff --git a/doc/ci/yaml/Screenshot 2023-09-28 at 13.01.18-fs8.png b/doc/ci/yaml/Screenshot 2023-09-28 at 13.01.18-fs8.png
new file mode 100644
index 00000000000..39a13bd7bc0
--- /dev/null
+++ b/doc/ci/yaml/Screenshot 2023-09-28 at 13.01.18-fs8.png
diff --git a/doc/ci/yaml/script.md b/doc/ci/yaml/script.md
index 71b9e9fbe0b..4d9befb2ae7 100644
--- a/doc/ci/yaml/script.md
+++ b/doc/ci/yaml/script.md
@@ -340,3 +340,15 @@ Resolve this by either:
           "Authorization: Bearer $CI_JOB_TOKEN" \
         "${CI_API_V4_URL}/job")
   ```
+
+### Job log output is not formatted as expected or contains unexpected characters
+
+Sometimes the formatting in the job log displays incorrectly with tools that rely on the `TERM` environment variable for coloring or formatting. For example, with the `mypy` command:
+
+![Example output](<Screenshot 2023-09-28 at 13.01.18-fs8.png>)
+
+GitLab Runner runs the container's shell in non-interactive mode, so the shell's `TERM`
+environment variable is set to `dumb`. To fix the formatting for these tools, you can:
+
+- Add an additional script line to set `TERM=ansi` in the shell's environment before running the command.
+- Add a `TERM` [CI/CD variable](../variables/index.md) with a value of `ansi`.