restructure common issues in user

docs/user/common-issues/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Common Issues & Help",
+  "position": 110,
+  "link": {
+    "type": "doc",
+    "id": "user-common-issues-overview"
+  }
+}

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?).

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
+   ```

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)

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.

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"
+  }
+}

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?).

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
+   ```

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)

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.