diff --git a/README.md b/README.md
index b93ef6d..9019435 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,9 @@ How this works:
 
 To use the `issue-from-pytest-log` action in workflows, simply add a new step:
 
+> [!WARNING]
+> The action won't run properly unless the `issues: write` permission is requested as shown below.
+
 ```yaml
 jobs:
   my-job:
@@ -22,6 +25,9 @@ jobs:
       fail-fast: false
       ...
 
+    permissions:
+      issues: write
+
     ...
 
     - uses: actions/setup-python@v4
@@ -31,12 +37,12 @@ jobs:
 
     ...
 
-    - run: <
+    - run: |
         pip install --upgrade pytest-reportlog
 
     ...
 
-    - run: <
+    - run: |
         pytest --report-log pytest-log.jsonl
 
     ...