Additional information

-  Makes sure that reviewers who lost their way and ended up stranded in
   the middle of the testing infrastructures find their way out and into
   the tutorials.

.github/workflows/README.md

@@ -1,3 +1,13 @@
+# Automated test workflows
+
 This directory stores workflow scripts that are picked up by GitHub Actions to automatically perform test installations of V-pipe on Mac OS and Linux systems and run end-to-end tests by executing tutorials with real example data.
 This ensures successful installation and reproducible execution on different systems.
 For each update of V-pipe these workflow scripts are automatically executed and report about installation problems or troubles on the test data
+
+Some of these workflows rely on additional data present in the [`tests/` directory](../../tests).
+
+## Tutorials
+
+If you want to test your new V-pipe installation, we strongly encourage you to instead check our tutorials which provide real example data.
+
+Tutorials for your first steps with V-pipe for different scenarios are available in the [docs/](../../docs/README.md) sub-directory.

README.md

@@ -31,12 +31,11 @@ general:
 
 Also see [snakemake's documentation](https://snakemake.readthedocs.io/en/stable/executing/cli.html) to learn more about the command-line options available when executing the workflow.
 
-Tutorials introducing usage of V-pipe are available in the [docs/](docs/README.md) subdirectory.
-
 
 ### Tutorials
 
-Tutorials for your first steps with V-pipe for different scenarios are  available in the [docs/](docs/README.md) subdirectory.
+Tutorials for your first steps with V-pipe for different scenarios are available in the [docs/](docs/README.md) subdirectory.
+
 
 ### Using quick install script
 

tests/README.md

@@ -1,3 +1,11 @@
-This tests in this directory are not run routinely. 
+# Automated test datasets
 
-The workflow tests that are automatically performed upon each update on GitHub can be found at https://github.com/cbg-ethz/V-pipe/tree/master/.github/workflows.
+This directory contains small test datasets which are used for the automated testing of V-pipe as part of the development process.
+
+The workflow tests that are automatically performed upon each update on GitHub can be found in the [`.github/workflows` directory](../.github/workflows).
+
+## Tutorials
+
+If you want to test your new V-pipe installation, we strongly encourage you to instead check our tutorials which provide real example data.
+
+Tutorials for your first steps with V-pipe for different scenarios are available in the [docs/](../docs/README.md) subdirectory.