Add an entry in the docs.

Author: tobiasraabe

docs/source/_static/images/dry-run.svg

@@ -76,3 +76,15 @@ To stop the build of the project after the first `n` failures use
 $ pytask -x | --stop-after-first-failure  # Stop after the first failure
 $ pytask --max-failures 2                 # Stop after the second failure
 ```
+
+### Performing a dry-run
+
+If you want to see which tasks would be executed without executing them, you can do a
+dry-run.
+
+```console
+$ pytask --dry-run
+```
+
+```{image} /_static/images/dry-run.svg
+```

docs/source/tutorials/invoking_pytask.md

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+import pytask
+
+
+@pytask.mark.produces("out.txt")
+def task_dry_run(produces):
+    produces.write_text("This text file won't be produced in a dry-run.")
+
+
+if __name__ == "__main__":
+    pytask.console.record = True
+    pytask.main({"paths": __file__, "dry_run": True})
+    pytask.console.save_svg("dry-run.svg", title="pytask")