From 6a9834c8d0608560e71280ac8487f221719371bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=BCrgen=20Weigert?= <jnweiger@gmail.com>
Date: Thu, 21 May 2026 17:28:28 +0200
Subject: [PATCH 1/3] common-issues symlink example

Completed the symlink example.
Step 2 was missing. Without that its not a symlink :-)
---
 docs/user/common-issues.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/user/common-issues.md b/docs/user/common-issues.md
index 72fb5932..98f097a3 100644
--- a/docs/user/common-issues.md
+++ b/docs/user/common-issues.md
@@ -34,12 +34,19 @@ If you want to synchronize a folder that is located outside your sync root, you
 
 You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.
 
-1. Move the folder into your sync root:
+1. Move the folder into (a sub-folder of) your sync root:
 
    ```bash
+   mkdir -p /home/bar/OpenCloud/Personal/foo/
    mv /foo/A /home/bar/OpenCloud/Personal/foo/A
    ```
 
+2. Create a symlink in the original place:
+
+   ```bash
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
+   ```
+
 ## Files with "~$" in the name will not be synchronized
 
 The OpenCloud Desktop Client does not synchronize files starting with `~$`, such as `~$document.docx`.  

From 19b5361f52e3d30ac0c275b5a85e4742ea81cde3 Mon Sep 17 00:00:00 2001
From: Juergen Weigert <j.weigert@heinlein-support.de>
Date: Thu, 21 May 2026 18:18:58 +0200
Subject: [PATCH 2/3] Same example in German translation.

---
 .../current/user/common-issues.md                 | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
index 34e97fb8..d346bd7f 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
@@ -28,21 +28,28 @@ Symlinks werden aus mehreren wichtigen Gründen bewusst von der Synchronisation
 
 #### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden
 
-Wenn Sie einen Ordner außerhalb Ihres Synchronisationsverzeichnisses synchronisieren möchten, können Sie diesen verschieben und am ursprünglichen Ort durch einen Symlink ersetzen.
+Wenn Sie einen Ordner außerhalb Ihres Synchronisationsverzeichnisses (Sync-Root) synchronisieren möchten, können Sie diesen in die Sync-Root verschieben und am ursprünglichen Ort durch einen Symlink ersetzen.
 
 ##### Beispiel
 
 Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihr Sync-Root ist `/home/bar/OpenCloud/Personal`.
 
-1. Verschieben Sie den Ordner in das Synchronisationsverzeichnis:
+1. Verschieben Sie den Ordner in die Sync-Root (in ein geeignetes Unterverzeichnis):
+
+    ```bash
+    mkdir -p /home/bar/OpenCloud/Personal/foo/
+    mv /foo/A /home/bar/OpenCloud/Personal/foo/A
+    ```
+
+2. Erstellen Sie einen Symlink:
 
    ```bash
-   mv /foo/A /home/bar/OpenCloud/Personal/foo/A
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
    ```
 
 ## Dateien mit "~$" im Namen werden nicht synchronisiert
 
-Der OpenCloud Desktop Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.  
+Der OpenCloud Desktop Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.
 Dabei handelt es sich um temporäre Sperrdateien, die von Microsoft Office-Anwendungen (Word, Excel, PowerPoint) erstellt werden, solange ein Dokument geöffnet ist.
 
 <img src={require("./img/common-issues/desktop-excluded.png").default} alt="Anzeige, dass ~$ Dateien von der Synchronisierung ausgeschlossen sind" width="500"/>

From bf8c03b1075193869041d33e738755667638162f Mon Sep 17 00:00:00 2001
From: Juergen Weigert <j.weigert@heinlein-support.de>
Date: Thu, 21 May 2026 18:21:59 +0200
Subject: [PATCH 3/3] .

---
 .../current/user/common-issues.md                               | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
index d346bd7f..d416822f 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
@@ -32,7 +32,7 @@ Wenn Sie einen Ordner außerhalb Ihres Synchronisationsverzeichnisses (Sync-Root
 
 ##### Beispiel
 
-Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihr Sync-Root ist `/home/bar/OpenCloud/Personal`.
+Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihre Sync-Root ist `/home/bar/OpenCloud/Personal`.
 
 1. Verschieben Sie den Ordner in die Sync-Root (in ein geeignetes Unterverzeichnis):