From e1f3a8f3745ed26c1a9395282eda421adee4bba7 Mon Sep 17 00:00:00 2001
From: Mark Herwege <mherwege@users.noreply.github.com>
Date: Tue, 18 Feb 2025 18:32:15 +0100
Subject: [PATCH] alias documentation (#2462)

Signed-off-by: Mark Herwege <mark.herwege@telenet.be>
---
 configuration/persistence.md | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/configuration/persistence.md b/configuration/persistence.md
index 4c1e16a00..44eedbc38 100644
--- a/configuration/persistence.md
+++ b/configuration/persistence.md
@@ -156,8 +156,8 @@ The syntax is as follows:
 
 ```java
 Items {
-    <itemlist1> [-> "<alias1>"] : [strategy = <strategy1>, <strategy2>, ...] [filter = <filter1>, <filter2>, ...]
-    <itemlist2> [-> "<alias2>"] : [strategy = <strategyX>, <strategyY>, ...]
+    <itemlist1> : [strategy = <strategy1>, <strategy2>, ...] [filter = <filter1>, <filter2>, ...]
+    <itemlist2> : [strategy = <strategyX>, <strategyY>, ...]
     ...
 
 }
@@ -176,6 +176,22 @@ The entries are additive.
 This means if one Item appears in more than one `<itemlist>` either directly or indirectly (e.g. `*` which includes all Items or as a member of a Group used in `<groupName>*`), all the strategies strategies listed on all those lines apply to that Item.
 In the same way, an Item defined by a `!<itemName>` or `!<groupName>*` will be excluded after all additive rules have been applied.
 
+### Aliases
+
+This section defines alternative names for items that will be used in storage by the persistence service.
+The syntax is as follows:
+
+```java
+Aliases {
+    <itemName1> -> <alias1>
+    <itemName2> -> <alias2>
+    ...
+
+}
+```
+
+Note that aliases should be unique and should not have the same name as an existing item that is also stored in the persistence service.
+
 Below you will find a complete example persistence configuration file:
 
 ```java