From 7a4451484f20971f9f11e210c990e3b25ba2ffc4 Mon Sep 17 00:00:00 2001
From: Peter Bieringer <pb@bieringer.de>
Date: Fri, 3 Apr 2026 16:35:11 +0200
Subject: [PATCH] sharing/doc: add note about attributes

---
 SHARING.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/SHARING.md b/SHARING.md
index a6b870c4..3c77061b 100644
--- a/SHARING.md
+++ b/SHARING.md
@@ -589,6 +589,24 @@ Whitelisted ones are defined in `OVERLAY_PROPERTIES_WHITELIST` in `radicale/shar
  * `enforce_properties_overlay`
    * supported *share* permissions: `Ee`
 
+#### Properties Overlay Control Precedence
+
+##### General Permission for Overlay
+
+ 1. permission of particular share configuration: `p` or `P`
+
+ 2. permission based on `rights` per location: `p` or `P`
+
+ 3. config option: `permit_properties_overlay`
+
+##### Enforce Overlay on Write
+
+ 1. permission of particular share configuration: `e` or `E`
+
+ 2. permission based on `rights` per location: `e` or `E`
+
+ 3. config option: `enforce_properties_overlay`
+
 ### Properties Overlay Example
 
 #### Requirements