From b9248ff6e7a1d384dc7977d5d38daeb127248411 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
 <26327373+vkucera@users.noreply.github.com>
Date: Thu, 4 Jun 2026 19:42:35 +0200
Subject: [PATCH 1/2] Troubleshooting: Add instructions on what info to provide

---
 docs/troubleshooting/README.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/troubleshooting/README.md b/docs/troubleshooting/README.md
index 1155e6a5..3887f426 100644
--- a/docs/troubleshooting/README.md
+++ b/docs/troubleshooting/README.md
@@ -41,7 +41,7 @@ grep -e "\\[ERROR\\]" -e "\\[FATAL\\]" -e "\\[CRITICAL\\]" -e "segmentation" -e
 
 See also [shell rc utilities](../tools/README.md#shell-rc-utilities).
 
-Try to understand and resolve the first reported problem.
+Try to understand and resolve the reported problems in order of appearance.
 
 ```note
 You can inspect a failing [AliHyperloop test](../hyperloop/userdocumentation.md#-wagon-tests) in the same way. The log is saved in the `stdout.log` file in the test output directory.
@@ -54,6 +54,16 @@ See the [Support](../gettingstarted/support.md) section for the list of Mattermo
 When asking for help with compilation or with running a local analysis, it may be useful to provide basic information about your O2Physics setup.
 You can generate it using the [Setup diagnostic tool](../tools/README.md#setup-diagnostic-tool).
 
+When asking for help with running an analysis:
+
+- If the problem is on AliHyperloop, provide:
+  - the link to the read-only view of the [wagon test](../hyperloop/userdocumentation.md#-wagon-tests) or the [train run](../hyperloop/userdocumentation.md#train-runs).
+- If the problem is local, provide:
+  - the name of the dataset of the input files,
+  - the command or script used to run the analysis,
+  - the log file,
+  - the dumped `dpl-config.json` file (and the input JSON file, if the dumped one is incomplete).
+
 When posting on Mattermost:
 
 - Do not paste the entire content of files or any long blocks of log lines or code directly in the message. If needed, attach the file.

From 7e3b54f285be21989224b2695dc67ccac987f919 Mon Sep 17 00:00:00 2001
From: ALICE Action Bot <alibuild@cern.ch>
Date: Thu, 4 Jun 2026 18:02:18 +0000
Subject: [PATCH 2/2] MegaLinter fixes

---
 docs/troubleshooting/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/troubleshooting/README.md b/docs/troubleshooting/README.md
index 3887f426..624d092c 100644
--- a/docs/troubleshooting/README.md
+++ b/docs/troubleshooting/README.md
@@ -190,7 +190,7 @@ Error in <TJAlienConnectionManager>: Failed to connect to any server! Giving up
 - You should be greeted with `Welcome to the ALICE GRID`.
 - Exit with `exit`.
 
-### shmem: could not create a message of size ...
+### shmem: could not create a message of size
 
 Add `--shm-segment-size 1000000000` (or larger number) to your o2 command.
 It is due to shared memory segment that is probably outdated for the size of the intermediate tables you have. It is actually set as 90% of system's max VSIZE allowance set in limits, or 2GB if the limits cannot be found, which is probably what happens in your case.