From 583adee7804faf9f38bec338299226facb72e376 Mon Sep 17 00:00:00 2001
From: Earl Warren <contact@earl-warren.org>
Date: Fri, 29 Aug 2025 12:38:25 +0000
Subject: [PATCH] chore: add reminder of how to run a local test (#917)

So that it can be copy/pasted.

<!--start release-notes-assistant-->
<!--URL:https://code.forgejo.org/forgejo/runner-->
- other
  - [PR](https://code.forgejo.org/forgejo/runner/pulls/917): <!--number 917 --><!--line 0 --><!--description Y2hvcmU6IGFkZCByZW1pbmRlciBvZiBob3cgdG8gcnVuIGEgbG9jYWwgdGVzdA==-->chore: add reminder of how to run a local test<!--description-->
<!--end release-notes-assistant-->

Reviewed-on: https://code.forgejo.org/forgejo/runner/pulls/917
Reviewed-by: Mathieu Fenniak <mfenniak@noreply.code.forgejo.org>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index f21e6a7d..d01f6e11 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,13 @@ The [workflow](.forgejo/workflows/test.yml) that runs in the CI uses similar com
 - Install [Docker](https://docs.docker.com/engine/install/)
 - `make test integration-test`
 
+The `TestRunner_RunEvent` test suite contains most integration tests
+with real-world workflows and is time-consuming to run. During
+development, it is helpful to run a specific test through a targeted
+command such as this:
+
+- `go test -count=1 -run='TestRunner_RunEvent$/local-action-dockerfile$' ./act/runner`
+
 ### With a Forgejo instance
 
 - Run a Forgejo instance locally (for instance at http://0.0.0.0:8080) and create as shared secret