From 8e8043b0e7112f964948ef4fdca895e739afaef6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mareks=20Ramp=C4=81ns?=
 <8796159+mr-git@users.noreply.github.com>
Date: Mon, 24 Aug 2026 12:22:52 +0300
Subject: [PATCH] Improve the README

---
 README.md | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 7b7f8dc..68b2c28 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,9 @@ on:
     branches: [ master ]
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   test:
     uses: evolution-gaming/scala-github-actions/.github/workflows/ci.yml@<sha> # v6.4.0
@@ -195,17 +198,20 @@ To use Scala Release workflow have to set up project:
   ```
 * create `release.yml` file with content:
   ```yaml
-    name: Publish Release
-    
-    on:
-      push:
-        tags:
-          - 'v*'
-    
-    jobs:
-      release:
-        uses: evolution-gaming/scala-github-actions/.github/workflows/release.yml@v5
-        secrets: inherit
+  name: Publish Release
+  
+  on:
+    push:
+      tags:
+        - 'v*'
+  
+  permissions:
+    contents: write # can delete tag on failed release attempt
+  
+  jobs:
+    release:
+      uses: evolution-gaming/scala-github-actions/.github/workflows/release.yml@v5
+      secrets: inherit
     ```
 
 ### Usage