From 048ed2d0bf4214904b0e18f2c6ab06c75b97d640 Mon Sep 17 00:00:00 2001
From: zainab-ali <zainab@kebab-ca.se>
Date: Tue, 9 Jun 2026 10:52:45 +0100
Subject: [PATCH] Add GitLab source URL format to documentation.

---
 docs/features/troubleshooting_failures.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/features/troubleshooting_failures.md b/docs/features/troubleshooting_failures.md
index f50d1444..27fe525c 100644
--- a/docs/features/troubleshooting_failures.md
+++ b/docs/features/troubleshooting_failures.md
@@ -217,6 +217,14 @@ You can display urls in other CI providers using the `WEAVER_SOURCE_URL` environ
 export WEAVER_SOURCE_URL=https://gitlab.com/my-org/my-repo/-/tree/my-branch/
 ```
 
+Here are some common provider formats:
+
+| Provider | `WEAVER_SOURCE_URL` value                                                        |
+|----------|----------------------------------------------------------------------------------|
+| GitHub   | `${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/tree/${GITHUB_SHA}/` (set by default) |
+| GitLab   | `${CI_PROJECT_URL}/-/tree/${CI_COMMIT_SHA}/`                                     |
+
+
 ## Displaying a trace
 
 If you have a test codebase with many nested helper functions, you may want to display a trace of source locations. You can do this with the `traced(here)` function.