From 1a30ce7780bf6032ec0688d73c10b91011745f15 Mon Sep 17 00:00:00 2001
From: Anja Barz <a.barz@opencloud.eu>
Date: Thu, 10 Sep 2026 13:43:10 +0200
Subject: [PATCH] restructure common issues in user

---
 docs/user/common-issues.md                    | 60 -------------------
 docs/user/common-issues/_category_.json       |  8 +++
 .../desktop-client-office-lock-files.md       | 26 ++++++++
 .../common-issues/desktop-client-symlinks.md  | 47 +++++++++++++++
 docs/user/common-issues/index.md              | 17 ++++++
 docs/user/index.md                            |  2 +-
 .../current/user/common-issues.md             | 60 -------------------
 .../user/common-issues/_category_.json        |  8 +++
 .../desktop-client-office-lock-files.md       | 26 ++++++++
 .../common-issues/desktop-client-symlinks.md  | 47 +++++++++++++++
 .../current/user/common-issues/index.md       | 17 ++++++
 .../current/user/index.md                     |  2 +-
 .../version-7.2/user/common-issues.md         | 60 -------------------
 .../user/common-issues/_category_.json        |  8 +++
 .../desktop-client-office-lock-files.md       | 26 ++++++++
 .../common-issues/desktop-client-symlinks.md  | 47 +++++++++++++++
 .../version-7.2/user/common-issues/index.md   | 17 ++++++
 .../version-7.2/user/index.md                 |  2 +-
 .../version-7.2/user/common-issues.md         | 60 -------------------
 .../user/common-issues/_category_.json        |  8 +++
 .../desktop-client-office-lock-files.md       | 26 ++++++++
 .../common-issues/desktop-client-symlinks.md  | 47 +++++++++++++++
 .../version-7.2/user/common-issues/index.md   | 17 ++++++
 versioned_docs/version-7.2/user/index.md      |  2 +-
 24 files changed, 396 insertions(+), 244 deletions(-)
 delete mode 100644 docs/user/common-issues.md
 create mode 100644 docs/user/common-issues/_category_.json
 create mode 100644 docs/user/common-issues/desktop-client-office-lock-files.md
 create mode 100644 docs/user/common-issues/desktop-client-symlinks.md
 create mode 100644 docs/user/common-issues/index.md
 delete mode 100644 i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/_category_.json
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-office-lock-files.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-symlinks.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/index.md
 delete mode 100644 i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/_category_.json
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-symlinks.md
 create mode 100644 i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/index.md
 delete mode 100644 versioned_docs/version-7.2/user/common-issues.md
 create mode 100644 versioned_docs/version-7.2/user/common-issues/_category_.json
 create mode 100644 versioned_docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
 create mode 100644 versioned_docs/version-7.2/user/common-issues/desktop-client-symlinks.md
 create mode 100644 versioned_docs/version-7.2/user/common-issues/index.md

diff --git a/docs/user/common-issues.md b/docs/user/common-issues.md
deleted file mode 100644
index 87ef8725..00000000
--- a/docs/user/common-issues.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-sidebar_position: 110
-id: common-issues
-title: Common Issues & Help
-description: Common issues & help
-draft: false
----
-
-# Common Issues & Help
-
-## Symlinks are not synchronized with the Desktop Client
-
-### Problem
-
-Symbolic links (symlinks) are not synchronized by the OpenCloud Desktop Client. Users often wonder why linked folders or files are missing or not accessible.
-
-### Reasoning
-
-Symlinks are deliberately excluded from synchronization for several important reasons:
-
-- Not portable: Symlinks often point to paths that only exist on the original machine. On another device, the target path likely doesn't exist.
-- Not usable in the web interface: The web interface cannot interpret or display symlinks.
-- Problematic on Windows: Symlink support on Windows is limited and inconsistent.
-- Risk of circular references: Symlinks could point to each other in loops, causing infinite synchronization cycles.
-- Loss of identity: If the client were to follow the link and synchronize the target, it would become a regular copy of the data. The original nature of the symlink would be lost.
-
-### Solution
-
-Sync Folders Outside the Sync Root Using Symlinks
-
-If you want to synchronize a folder that is located outside your sync root, you can still achieve this by moving the folder into your sync root and replacing the original location with a symlink.
-
-#### Example
-
-You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.
-
-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`.  
-These files are temporary lock files created by Microsoft Office applications (Word, Excel, PowerPoint) while a document is open.
-
-<img src={require("./img/common-issues/desktop-excluded.png").default} alt="Show the ~$ file is excluded from synchronizing" width="500"/>
-
-They are not actual content files but serve as internal markers to prevent multiple users from editing the same document simultaneously.  
-Once the file is closed, the `~$` file is automatically removed by Office.
-
-For more details, see the [Microsoft support article on temporary Office lock files created by Word/Excel/PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/docs/user/common-issues/_category_.json b/docs/user/common-issues/_category_.json
new file mode 100644
index 00000000..46b501c4
--- /dev/null
+++ b/docs/user/common-issues/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Common Issues & Help",
+  "position": 110,
+  "link": {
+    "type": "doc",
+    "id": "user-common-issues-overview"
+  }
+}
diff --git a/docs/user/common-issues/desktop-client-office-lock-files.md b/docs/user/common-issues/desktop-client-office-lock-files.md
new file mode 100644
index 00000000..ac2404d2
--- /dev/null
+++ b/docs/user/common-issues/desktop-client-office-lock-files.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 3
+id: desktop-client-office-lock-files
+title: Microsoft Office lock files are not synchronized
+description: Understand why the Desktop Client excludes Microsoft Office lock files
+draft: false
+hide_table_of_contents: true
+---
+
+# Microsoft Office lock files are not synchronized
+
+## Problem
+
+The OpenCloud Desktop Client does not synchronize files starting with `~$`, such as `~$document.docx`.
+
+<img src={require("../img/common-issues/desktop-excluded.png").default} alt="Show the ~$ file is excluded from synchronizing" width="500"/>
+
+## Cause
+
+These files are temporary lock files created by Microsoft Office applications while a document is open. They are internal markers that prevent multiple users from editing the same document simultaneously, rather than content files.
+
+## Solution
+
+Close the document in Microsoft Office. Office automatically removes the corresponding `~$` file.
+
+For more details, see the [Microsoft support article on temporary Office lock files created by Word, Excel, and PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/docs/user/common-issues/desktop-client-symlinks.md b/docs/user/common-issues/desktop-client-symlinks.md
new file mode 100644
index 00000000..2c6a1ac7
--- /dev/null
+++ b/docs/user/common-issues/desktop-client-symlinks.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 2
+id: desktop-client-symlinks
+title: Symlinks are not synchronized
+description: Understand how the Desktop Client handles symbolic links
+draft: false
+hide_table_of_contents: true
+---
+
+# Symlinks are not synchronized with the Desktop Client
+
+## Problem
+
+Symbolic links (symlinks) are not synchronized by the OpenCloud Desktop Client. Linked folders or files may be missing or inaccessible.
+
+## Cause
+
+Symlinks are deliberately excluded from synchronization for several reasons:
+
+- Not portable: Symlinks often point to paths that only exist on the original machine. On another device, the target path likely doesn't exist.
+- Not usable in the web interface: The web interface cannot interpret or display symlinks.
+- Problematic on Windows: Symlink support on Windows is limited and inconsistent.
+- Risk of circular references: Symlinks could point to each other in loops, causing infinite synchronization cycles.
+- Loss of identity: If the client followed the link and synchronized the target, it would become a regular copy of the data and lose its original nature as a symlink.
+
+## Solution
+
+### Sync folders outside the sync root using symlinks
+
+To synchronize a folder outside your sync root, move the folder into the sync root and replace its original location with a symlink.
+
+#### Example
+
+You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.
+
+1. Move the folder into a subfolder 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 location:
+
+   ```bash
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
+   ```
diff --git a/docs/user/common-issues/index.md b/docs/user/common-issues/index.md
new file mode 100644
index 00000000..2877a74b
--- /dev/null
+++ b/docs/user/common-issues/index.md
@@ -0,0 +1,17 @@
+---
+sidebar_position: 1
+id: user-common-issues-overview
+title: Common Issues & Help
+description: Common issues and help
+draft: false
+toc_max_heading_level: 2
+---
+
+# Common Issues & Help
+
+Use this page to find troubleshooting guidance for common user issues.
+
+## Desktop Client
+
+- [Symlinks are not synchronized](./desktop-client-symlinks.md)
+- [Microsoft Office lock files are not synchronized](./desktop-client-office-lock-files.md)
diff --git a/docs/user/index.md b/docs/user/index.md
index 6fddcd1d..e71e04c4 100644
--- a/docs/user/index.md
+++ b/docs/user/index.md
@@ -95,5 +95,5 @@ You can switch between the Rolling version and specific release versions using t
 
 ### Help
 
-- [Common Issues and Help](./common-issues)  
+- [Common Issues and Help](./common-issues/index.md)
   Find solutions for common problems and answers to frequently asked questions.
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
deleted file mode 100644
index 100ff6e2..00000000
--- a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-sidebar_position: 110
-id: common-issues
-title: Häufige Probleme & Hilfe
-description: Häufige Probleme & Hilfe
-draft: false
----
-
-# Häufige Probleme & Hilfe
-
-## Symlinks werden mit dem Desktop-Client nicht synchronisiert
-
-### Problem
-
-Symbolische Links (Symlinks) werden vom OpenCloud Desktop-Client nicht synchronisiert. Nutzer stellen häufig fest, dass verlinkte Ordner oder Dateien fehlen oder nicht zugänglich sind.
-
-### Erklärung
-
-Symlinks werden aus mehreren wichtigen Gründen bewusst von der Synchronisation ausgeschlossen:
-
-- Nicht portabel: Symlinks verweisen oft auf Pfade, die nur auf dem ursprünglichen Rechner existieren. Auf einem anderen Gerät ist der Zielpfad in der Regel nicht vorhanden.
-- Nicht im Webinterface nutzbar: Das Webinterface kann Symlinks nicht interpretieren oder darstellen.
-- Problematisch unter Windows: Die Unterstützung von Symlinks unter Windows ist eingeschränkt und inkonsistent.
-- Gefahr von Endlosschleifen: Symlinks könnten aufeinander verweisen und so zu einer endlosen Synchronisationsschleife führen.
-- Identitätsverlust: Wenn der Client dem Symlink folgen und das Ziel synchronisieren würde, entstünde lediglich eine reguläre Kopie. Die Eigenschaft als Symlink ginge dabei verloren.
-
-### Lösung
-
-#### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden
-
-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 Ihre Sync-Root ist `/home/bar/OpenCloud/Personal`.
-
-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
-   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`.
-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"/>
-
-Es sind keine eigentlichen Inhaltsdateien, sondern interne Marker, die verhindern sollen, dass mehrere Benutzer gleichzeitig dasselbe Dokument bearbeiten.  
-Sobald die Datei geschlossen wird, entfernt Office die `~$`-Datei automatisch.
-
-Weitere Informationen finden Sie in dem [Microsoft-Supportartikel zu temporären Office-Sperrdateien von Word/Excel/PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/_category_.json b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/_category_.json
new file mode 100644
index 00000000..9bb6fdc3
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Häufige Probleme & Hilfe",
+  "position": 110,
+  "link": {
+    "type": "doc",
+    "id": "user-common-issues-overview"
+  }
+}
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-office-lock-files.md b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-office-lock-files.md
new file mode 100644
index 00000000..d12155ed
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-office-lock-files.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 3
+id: desktop-client-office-lock-files
+title: Microsoft-Office-Sperrdateien werden nicht synchronisiert
+description: Warum der Desktop-Client Microsoft-Office-Sperrdateien ausschließt
+draft: false
+hide_table_of_contents: true
+---
+
+# Microsoft-Office-Sperrdateien werden nicht synchronisiert
+
+## Problem
+
+Der OpenCloud Desktop-Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.
+
+<img src={require("../img/common-issues/desktop-excluded.png").default} alt="Anzeige, dass ~$ Dateien von der Synchronisierung ausgeschlossen sind" width="500"/>
+
+## Ursache
+
+Diese Dateien sind temporäre Sperrdateien, die von Microsoft-Office-Anwendungen erstellt werden, solange ein Dokument geöffnet ist. Es sind keine Inhaltsdateien, sondern interne Marker, die verhindern, dass mehrere Benutzer gleichzeitig dasselbe Dokument bearbeiten.
+
+## Lösung
+
+Schließen Sie das Dokument in Microsoft Office. Office entfernt die zugehörige `~$`-Datei automatisch.
+
+Weitere Informationen finden Sie im [Microsoft-Supportartikel zu temporären Office-Sperrdateien von Word, Excel und PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-symlinks.md b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-symlinks.md
new file mode 100644
index 00000000..00f0f22b
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/desktop-client-symlinks.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 2
+id: desktop-client-symlinks
+title: Symlinks werden nicht synchronisiert
+description: Umgang des Desktop-Clients mit symbolischen Links
+draft: false
+hide_table_of_contents: true
+---
+
+# Symlinks werden mit dem Desktop-Client nicht synchronisiert
+
+## Problem
+
+Symbolische Links (Symlinks) werden vom OpenCloud Desktop-Client nicht synchronisiert. Verlinkte Ordner oder Dateien können fehlen oder nicht zugänglich sein.
+
+## Ursache
+
+Symlinks werden aus mehreren Gründen bewusst von der Synchronisation ausgeschlossen:
+
+- Nicht portabel: Symlinks verweisen oft auf Pfade, die nur auf dem ursprünglichen Rechner existieren. Auf einem anderen Gerät ist der Zielpfad in der Regel nicht vorhanden.
+- Nicht im Webinterface nutzbar: Das Webinterface kann Symlinks nicht interpretieren oder darstellen.
+- Problematisch unter Windows: Die Unterstützung von Symlinks unter Windows ist eingeschränkt und inkonsistent.
+- Gefahr von Endlosschleifen: Symlinks könnten aufeinander verweisen und so zu einer endlosen Synchronisationsschleife führen.
+- Identitätsverlust: Würde der Client dem Link folgen und das Ziel synchronisieren, entstünde eine reguläre Kopie der Daten. Die ursprüngliche Eigenschaft als Symlink ginge verloren.
+
+## Lösung
+
+### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden
+
+Um einen Ordner außerhalb Ihres Synchronisationsverzeichnisses zu synchronisieren, verschieben Sie ihn in das Synchronisationsverzeichnis und ersetzen seinen ursprünglichen Speicherort durch einen Symlink.
+
+#### Beispiel
+
+Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihr Synchronisationsverzeichnis ist `/home/bar/OpenCloud/Personal`.
+
+1. Verschieben Sie den Ordner in ein Unterverzeichnis Ihres Synchronisationsverzeichnisses:
+
+   ```bash
+   mkdir -p /home/bar/OpenCloud/Personal/foo/
+   mv /foo/A /home/bar/OpenCloud/Personal/foo/A
+   ```
+
+2. Erstellen Sie am ursprünglichen Speicherort einen Symlink:
+
+   ```bash
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
+   ```
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/index.md b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/index.md
new file mode 100644
index 00000000..e3f16d81
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/common-issues/index.md
@@ -0,0 +1,17 @@
+---
+sidebar_position: 1
+id: user-common-issues-overview
+title: Häufige Probleme & Hilfe
+description: Häufige Probleme und Hilfe
+draft: false
+toc_max_heading_level: 2
+---
+
+# Häufige Probleme & Hilfe
+
+Auf dieser Seite finden Sie Hilfestellungen zu häufigen Problemen im User-Bereich.
+
+## Desktop-Client
+
+- [Symlinks werden nicht synchronisiert](./desktop-client-symlinks.md)
+- [Microsoft-Office-Sperrdateien werden nicht synchronisiert](./desktop-client-office-lock-files.md)
diff --git a/i18n/de/docusaurus-plugin-content-docs/current/user/index.md b/i18n/de/docusaurus-plugin-content-docs/current/user/index.md
index a544aa9e..10a84d44 100644
--- a/i18n/de/docusaurus-plugin-content-docs/current/user/index.md
+++ b/i18n/de/docusaurus-plugin-content-docs/current/user/index.md
@@ -94,5 +94,5 @@ Diese Dokumentation ist versioniert, damit Sie die Informationen passend zu Ihre
 
 ### Hilfe
 
-- [Häufige Probleme und Hilfe](./common-issues)  
+- [Häufige Probleme und Hilfe](./common-issues/index.md)
   Hier finden Sie Lösungen für häufige Probleme und Antworten auf häufig gestellte Fragen.
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues.md b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues.md
deleted file mode 100644
index 100ff6e2..00000000
--- a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-sidebar_position: 110
-id: common-issues
-title: Häufige Probleme & Hilfe
-description: Häufige Probleme & Hilfe
-draft: false
----
-
-# Häufige Probleme & Hilfe
-
-## Symlinks werden mit dem Desktop-Client nicht synchronisiert
-
-### Problem
-
-Symbolische Links (Symlinks) werden vom OpenCloud Desktop-Client nicht synchronisiert. Nutzer stellen häufig fest, dass verlinkte Ordner oder Dateien fehlen oder nicht zugänglich sind.
-
-### Erklärung
-
-Symlinks werden aus mehreren wichtigen Gründen bewusst von der Synchronisation ausgeschlossen:
-
-- Nicht portabel: Symlinks verweisen oft auf Pfade, die nur auf dem ursprünglichen Rechner existieren. Auf einem anderen Gerät ist der Zielpfad in der Regel nicht vorhanden.
-- Nicht im Webinterface nutzbar: Das Webinterface kann Symlinks nicht interpretieren oder darstellen.
-- Problematisch unter Windows: Die Unterstützung von Symlinks unter Windows ist eingeschränkt und inkonsistent.
-- Gefahr von Endlosschleifen: Symlinks könnten aufeinander verweisen und so zu einer endlosen Synchronisationsschleife führen.
-- Identitätsverlust: Wenn der Client dem Symlink folgen und das Ziel synchronisieren würde, entstünde lediglich eine reguläre Kopie. Die Eigenschaft als Symlink ginge dabei verloren.
-
-### Lösung
-
-#### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden
-
-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 Ihre Sync-Root ist `/home/bar/OpenCloud/Personal`.
-
-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
-   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`.
-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"/>
-
-Es sind keine eigentlichen Inhaltsdateien, sondern interne Marker, die verhindern sollen, dass mehrere Benutzer gleichzeitig dasselbe Dokument bearbeiten.  
-Sobald die Datei geschlossen wird, entfernt Office die `~$`-Datei automatisch.
-
-Weitere Informationen finden Sie in dem [Microsoft-Supportartikel zu temporären Office-Sperrdateien von Word/Excel/PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/_category_.json b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/_category_.json
new file mode 100644
index 00000000..9bb6fdc3
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Häufige Probleme & Hilfe",
+  "position": 110,
+  "link": {
+    "type": "doc",
+    "id": "user-common-issues-overview"
+  }
+}
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
new file mode 100644
index 00000000..d12155ed
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 3
+id: desktop-client-office-lock-files
+title: Microsoft-Office-Sperrdateien werden nicht synchronisiert
+description: Warum der Desktop-Client Microsoft-Office-Sperrdateien ausschließt
+draft: false
+hide_table_of_contents: true
+---
+
+# Microsoft-Office-Sperrdateien werden nicht synchronisiert
+
+## Problem
+
+Der OpenCloud Desktop-Client synchronisiert keine Dateien, die mit `~$` beginnen, wie z. B. `~$document.docx`.
+
+<img src={require("../img/common-issues/desktop-excluded.png").default} alt="Anzeige, dass ~$ Dateien von der Synchronisierung ausgeschlossen sind" width="500"/>
+
+## Ursache
+
+Diese Dateien sind temporäre Sperrdateien, die von Microsoft-Office-Anwendungen erstellt werden, solange ein Dokument geöffnet ist. Es sind keine Inhaltsdateien, sondern interne Marker, die verhindern, dass mehrere Benutzer gleichzeitig dasselbe Dokument bearbeiten.
+
+## Lösung
+
+Schließen Sie das Dokument in Microsoft Office. Office entfernt die zugehörige `~$`-Datei automatisch.
+
+Weitere Informationen finden Sie im [Microsoft-Supportartikel zu temporären Office-Sperrdateien von Word, Excel und PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-symlinks.md b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-symlinks.md
new file mode 100644
index 00000000..00f0f22b
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/desktop-client-symlinks.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 2
+id: desktop-client-symlinks
+title: Symlinks werden nicht synchronisiert
+description: Umgang des Desktop-Clients mit symbolischen Links
+draft: false
+hide_table_of_contents: true
+---
+
+# Symlinks werden mit dem Desktop-Client nicht synchronisiert
+
+## Problem
+
+Symbolische Links (Symlinks) werden vom OpenCloud Desktop-Client nicht synchronisiert. Verlinkte Ordner oder Dateien können fehlen oder nicht zugänglich sein.
+
+## Ursache
+
+Symlinks werden aus mehreren Gründen bewusst von der Synchronisation ausgeschlossen:
+
+- Nicht portabel: Symlinks verweisen oft auf Pfade, die nur auf dem ursprünglichen Rechner existieren. Auf einem anderen Gerät ist der Zielpfad in der Regel nicht vorhanden.
+- Nicht im Webinterface nutzbar: Das Webinterface kann Symlinks nicht interpretieren oder darstellen.
+- Problematisch unter Windows: Die Unterstützung von Symlinks unter Windows ist eingeschränkt und inkonsistent.
+- Gefahr von Endlosschleifen: Symlinks könnten aufeinander verweisen und so zu einer endlosen Synchronisationsschleife führen.
+- Identitätsverlust: Würde der Client dem Link folgen und das Ziel synchronisieren, entstünde eine reguläre Kopie der Daten. Die ursprüngliche Eigenschaft als Symlink ginge verloren.
+
+## Lösung
+
+### Ordner außerhalb des Synchronisationsverzeichnisses mit Symlinks einbinden
+
+Um einen Ordner außerhalb Ihres Synchronisationsverzeichnisses zu synchronisieren, verschieben Sie ihn in das Synchronisationsverzeichnis und ersetzen seinen ursprünglichen Speicherort durch einen Symlink.
+
+#### Beispiel
+
+Sie möchten den Ordner `/foo/A` synchronisieren, aber Ihr Synchronisationsverzeichnis ist `/home/bar/OpenCloud/Personal`.
+
+1. Verschieben Sie den Ordner in ein Unterverzeichnis Ihres Synchronisationsverzeichnisses:
+
+   ```bash
+   mkdir -p /home/bar/OpenCloud/Personal/foo/
+   mv /foo/A /home/bar/OpenCloud/Personal/foo/A
+   ```
+
+2. Erstellen Sie am ursprünglichen Speicherort einen Symlink:
+
+   ```bash
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
+   ```
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/index.md b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/index.md
new file mode 100644
index 00000000..e3f16d81
--- /dev/null
+++ b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/common-issues/index.md
@@ -0,0 +1,17 @@
+---
+sidebar_position: 1
+id: user-common-issues-overview
+title: Häufige Probleme & Hilfe
+description: Häufige Probleme und Hilfe
+draft: false
+toc_max_heading_level: 2
+---
+
+# Häufige Probleme & Hilfe
+
+Auf dieser Seite finden Sie Hilfestellungen zu häufigen Problemen im User-Bereich.
+
+## Desktop-Client
+
+- [Symlinks werden nicht synchronisiert](./desktop-client-symlinks.md)
+- [Microsoft-Office-Sperrdateien werden nicht synchronisiert](./desktop-client-office-lock-files.md)
diff --git a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/index.md b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/index.md
index a544aa9e..10a84d44 100644
--- a/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/index.md
+++ b/i18n/de/docusaurus-plugin-content-docs/version-7.2/user/index.md
@@ -94,5 +94,5 @@ Diese Dokumentation ist versioniert, damit Sie die Informationen passend zu Ihre
 
 ### Hilfe
 
-- [Häufige Probleme und Hilfe](./common-issues)  
+- [Häufige Probleme und Hilfe](./common-issues/index.md)
   Hier finden Sie Lösungen für häufige Probleme und Antworten auf häufig gestellte Fragen.
diff --git a/versioned_docs/version-7.2/user/common-issues.md b/versioned_docs/version-7.2/user/common-issues.md
deleted file mode 100644
index 87ef8725..00000000
--- a/versioned_docs/version-7.2/user/common-issues.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-sidebar_position: 110
-id: common-issues
-title: Common Issues & Help
-description: Common issues & help
-draft: false
----
-
-# Common Issues & Help
-
-## Symlinks are not synchronized with the Desktop Client
-
-### Problem
-
-Symbolic links (symlinks) are not synchronized by the OpenCloud Desktop Client. Users often wonder why linked folders or files are missing or not accessible.
-
-### Reasoning
-
-Symlinks are deliberately excluded from synchronization for several important reasons:
-
-- Not portable: Symlinks often point to paths that only exist on the original machine. On another device, the target path likely doesn't exist.
-- Not usable in the web interface: The web interface cannot interpret or display symlinks.
-- Problematic on Windows: Symlink support on Windows is limited and inconsistent.
-- Risk of circular references: Symlinks could point to each other in loops, causing infinite synchronization cycles.
-- Loss of identity: If the client were to follow the link and synchronize the target, it would become a regular copy of the data. The original nature of the symlink would be lost.
-
-### Solution
-
-Sync Folders Outside the Sync Root Using Symlinks
-
-If you want to synchronize a folder that is located outside your sync root, you can still achieve this by moving the folder into your sync root and replacing the original location with a symlink.
-
-#### Example
-
-You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.
-
-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`.  
-These files are temporary lock files created by Microsoft Office applications (Word, Excel, PowerPoint) while a document is open.
-
-<img src={require("./img/common-issues/desktop-excluded.png").default} alt="Show the ~$ file is excluded from synchronizing" width="500"/>
-
-They are not actual content files but serve as internal markers to prevent multiple users from editing the same document simultaneously.  
-Once the file is closed, the `~$` file is automatically removed by Office.
-
-For more details, see the [Microsoft support article on temporary Office lock files created by Word/Excel/PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/versioned_docs/version-7.2/user/common-issues/_category_.json b/versioned_docs/version-7.2/user/common-issues/_category_.json
new file mode 100644
index 00000000..46b501c4
--- /dev/null
+++ b/versioned_docs/version-7.2/user/common-issues/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Common Issues & Help",
+  "position": 110,
+  "link": {
+    "type": "doc",
+    "id": "user-common-issues-overview"
+  }
+}
diff --git a/versioned_docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md b/versioned_docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
new file mode 100644
index 00000000..ac2404d2
--- /dev/null
+++ b/versioned_docs/version-7.2/user/common-issues/desktop-client-office-lock-files.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 3
+id: desktop-client-office-lock-files
+title: Microsoft Office lock files are not synchronized
+description: Understand why the Desktop Client excludes Microsoft Office lock files
+draft: false
+hide_table_of_contents: true
+---
+
+# Microsoft Office lock files are not synchronized
+
+## Problem
+
+The OpenCloud Desktop Client does not synchronize files starting with `~$`, such as `~$document.docx`.
+
+<img src={require("../img/common-issues/desktop-excluded.png").default} alt="Show the ~$ file is excluded from synchronizing" width="500"/>
+
+## Cause
+
+These files are temporary lock files created by Microsoft Office applications while a document is open. They are internal markers that prevent multiple users from editing the same document simultaneously, rather than content files.
+
+## Solution
+
+Close the document in Microsoft Office. Office automatically removes the corresponding `~$` file.
+
+For more details, see the [Microsoft support article on temporary Office lock files created by Word, Excel, and PowerPoint](https://support.microsoft.com/en-gb/topic/-the-document-is-locked-for-editing-by-another-user-error-message-when-you-try-to-open-a-document-in-word-10b92aeb-2e23-25e0-9110-370af6edb638?).
diff --git a/versioned_docs/version-7.2/user/common-issues/desktop-client-symlinks.md b/versioned_docs/version-7.2/user/common-issues/desktop-client-symlinks.md
new file mode 100644
index 00000000..2c6a1ac7
--- /dev/null
+++ b/versioned_docs/version-7.2/user/common-issues/desktop-client-symlinks.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 2
+id: desktop-client-symlinks
+title: Symlinks are not synchronized
+description: Understand how the Desktop Client handles symbolic links
+draft: false
+hide_table_of_contents: true
+---
+
+# Symlinks are not synchronized with the Desktop Client
+
+## Problem
+
+Symbolic links (symlinks) are not synchronized by the OpenCloud Desktop Client. Linked folders or files may be missing or inaccessible.
+
+## Cause
+
+Symlinks are deliberately excluded from synchronization for several reasons:
+
+- Not portable: Symlinks often point to paths that only exist on the original machine. On another device, the target path likely doesn't exist.
+- Not usable in the web interface: The web interface cannot interpret or display symlinks.
+- Problematic on Windows: Symlink support on Windows is limited and inconsistent.
+- Risk of circular references: Symlinks could point to each other in loops, causing infinite synchronization cycles.
+- Loss of identity: If the client followed the link and synchronized the target, it would become a regular copy of the data and lose its original nature as a symlink.
+
+## Solution
+
+### Sync folders outside the sync root using symlinks
+
+To synchronize a folder outside your sync root, move the folder into the sync root and replace its original location with a symlink.
+
+#### Example
+
+You want to synchronize the folder `/foo/A`, but your sync root is `/home/bar/OpenCloud/Personal`.
+
+1. Move the folder into a subfolder 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 location:
+
+   ```bash
+   ln -s /home/bar/OpenCloud/Personal/foo/A /foo/A
+   ```
diff --git a/versioned_docs/version-7.2/user/common-issues/index.md b/versioned_docs/version-7.2/user/common-issues/index.md
new file mode 100644
index 00000000..2877a74b
--- /dev/null
+++ b/versioned_docs/version-7.2/user/common-issues/index.md
@@ -0,0 +1,17 @@
+---
+sidebar_position: 1
+id: user-common-issues-overview
+title: Common Issues & Help
+description: Common issues and help
+draft: false
+toc_max_heading_level: 2
+---
+
+# Common Issues & Help
+
+Use this page to find troubleshooting guidance for common user issues.
+
+## Desktop Client
+
+- [Symlinks are not synchronized](./desktop-client-symlinks.md)
+- [Microsoft Office lock files are not synchronized](./desktop-client-office-lock-files.md)
diff --git a/versioned_docs/version-7.2/user/index.md b/versioned_docs/version-7.2/user/index.md
index 6fddcd1d..e71e04c4 100644
--- a/versioned_docs/version-7.2/user/index.md
+++ b/versioned_docs/version-7.2/user/index.md
@@ -95,5 +95,5 @@ You can switch between the Rolling version and specific release versions using t
 
 ### Help
 
-- [Common Issues and Help](./common-issues)  
+- [Common Issues and Help](./common-issues/index.md)
   Find solutions for common problems and answers to frequently asked questions.