From 96a629f252ba3ca7fe2ba450a4d74934668f3dae Mon Sep 17 00:00:00 2001
From: Neil Carvalho <me@neil.pro>
Date: Fri, 15 May 2026 21:53:07 -0300
Subject: [PATCH] Add instructions about enabling GitHub Actions PRs

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 66a1fec..5b55d1c 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,15 @@ This action fills that gap.
 
 ## Quick start
 
-Add a workflow file:
+For this action to work you must explicitly allow GitHub Actions to create pull
+requests. This setting can be found in a repository's settings under Actions >
+General > Workflow permissions.
+
+Another option is to use a dedicated GitHub token for this action, which can be
+set as a secret in the repository's settings. This token should have the `repo`
+scope enabled.
+
+Then, add a workflow file:
 
 ```yaml
 # .github/workflows/importmap-updates.yml