From 1dd03c62ad8f09b50dd77c18b973d4aee2112f7a Mon Sep 17 00:00:00 2001
From: Valentin Gagarin <valentin.gagarin@tweag.io>
Date: Fri, 29 Sep 2023 10:46:42 +0200
Subject: [PATCH] add hint for troubleshooting tests

---
 doc/manual/src/contributing/testing.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/manual/src/contributing/testing.md b/doc/manual/src/contributing/testing.md
index 881118505..4a7f1c15c 100644
--- a/doc/manual/src/contributing/testing.md
+++ b/doc/manual/src/contributing/testing.md
@@ -130,6 +130,15 @@ GNU gdb (GDB) 12.1
 One can debug the Nix invocation in all the usual ways.
 For example, enter `run` to start the Nix invocation.
 
+### Troubleshooting
+
+Sometimes running tests in the development shell may leave artefacts in the local repository.
+To remove any traces of that:
+
+```console
+git clean -x --force tests
+```
+
 ### Characterization testing
 
 Occasionally, Nix utilizes a technique called [Characterization Testing](https://en.wikipedia.org/wiki/Characterization_test) as part of the functional tests.