From b779826a2917b63194284afd36d9e4834337e686 Mon Sep 17 00:00:00 2001
From: Vincenzo Scamporlino <vincenzos@spotify.com>
Date: Thu, 5 Feb 2026 22:44:21 +0100
Subject: [PATCH] docs: clarify policy edit

Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
---
 docs/permissions/custom-rules.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/permissions/custom-rules.md b/docs/permissions/custom-rules.md
index cab9e73a6f..288c18137d 100644
--- a/docs/permissions/custom-rules.md
+++ b/docs/permissions/custom-rules.md
@@ -99,7 +99,11 @@ export const isInSystemRule = createPermissionRule({
     values: [systemRef],
   }),
 });
+```
 
+You can now use the rules above in your policy:
+
+```ts title="packages/backend/src/extensions/permissionsPolicyExtension.ts"
 const isInSystem = createConditionFactory(isInSystemRule);
 
 class CustomPermissionPolicy implements PermissionPolicy {
@@ -131,8 +135,6 @@ class CustomPermissionPolicy implements PermissionPolicy {
     return { result: AuthorizeResult.ALLOW };
   }
 }
-
-...
 ```
 
 ## Provide the rule during plugin setup