modify and add index.md for each sectionin user docs for better under… (#728)

* modify and add index.md for each sectionin user docs for better understanding and look and feel. Check links and fix wrong

* add .md to the links so they can be resolved

* remove german translation in sidebar

Author: Svanvith

docs/user/admin/_category_.json

@@ -2,8 +2,7 @@
   "label": "Administration of OpenCloud",
   "position": 9,
   "link": {
-    "type": "generated-index",
-    "description": "Tutorials for administrating your OpenCloud.",
-    "slug": "user/admin/"
+    "type": "doc",
+    "id": "admin-overview"
   }
 }

docs/user/admin/index.md

@@ -0,0 +1,20 @@
+---
+sidebar_position: 0
+id: admin-overview
+title: Administration of OpenCloud
+---
+
+# Administration of OpenCloud
+
+This section explains the administration features available in OpenCloud. Depending on your permissions, you can manage account settings, administer users, groups, and spaces, create app tokens, and connect external tools such as WebDAV clients.
+
+## In this section
+
+- [Settings](./settings.md)  
+  View the administration area and manage users, groups, and spaces, depending on your permissions.
+
+- [App Tokens](./app-tokens.md)  
+  Create and manage secure tokens for third-party applications and WebDAV clients.
+
+- [WebDAV](./web-dav.md)  
+  Connect OpenCloud files and spaces to your operating system or file manager using WebDAV.

docs/user/android-app/_category_.json

@@ -1,4 +1,8 @@
 {
   "label": "OpenCloud Android App",
-  "position": 8
+  "position": 8,
+  "link": {
+    "type": "doc",
+    "id": "android-app-overview"
+  }
 }

docs/user/android-app/index.md

@@ -1,20 +1,18 @@
 ---
+sidebar_position: 0
+id: android-app-overview
 title: OpenCloud Android App
 ---
 
-import DocCardList from '@theme/DocCardList';
+# OpenCloud Android App
 
-The OpenCloud Android app provides mobile access to OpenCloud on Android devices.  
-It offers essential functions for working on the go, including file management, uploads, and quick collaboration.
+The OpenCloud Android app provides mobile access to your files, spaces, and shares. It is designed for quick access on the go, with support for setup, search, shortcuts, and file management.
 
-#### Key Features
+## What you will find here
 
-- File management: view, upload, share, and organize files and folders
-- Access to spaces and their stored content
-- Full-text and metadata search for quickly finding documents
-- Support for collaborative editing via Web Office
-- Real-time synchronization of changes
-
-Use Case: Ideal for users who need mobile access to their OpenCloud data and want to handle essential tasks while on the go.
-
-<DocCardList />
+- [General](./general/) - Install the app, set it up, and learn the main interface and settings.
+- [Files and folders](./files-and-folders/) - Create and edit content, upload files, and make items available offline.
+- [Spaces](./spaces.md) - Work with Spaces and their available actions on Android.
+- [Search](./search.md) - Find files and folders from within the Android app.
+- [Shortcuts](./shortcuts.md) - Create shortcuts to files or web links.
+- [Shares](./shares/) - Invite people and create share links from the Android app.

docs/user/desktop-client/_category_.json

@@ -1,4 +1,8 @@
 {
   "label": "OpenCloud Desktop",
-  "position": 6
+  "position": 6,
+  "link": {
+    "type": "doc",
+    "id": "desktop-client-overview"
+  }
 }

docs/user/desktop-client/index.md

@@ -1,17 +1,23 @@
 ---
+sidebar_position: 0
+id: desktop-client-overview
 title: OpenCloud Desktop Client
 ---
 
-import DocCardList from '@theme/DocCardList';
+# OpenCloud Desktop Client
 
-The OpenCloud Desktop Client enables file synchronization between a local computer and OpenCloud.  
-It ensures that files are available offline and that changes are automatically synchronized once an internet connection is restored.  
-The client is available for Windows, macOS, and Linux.
+The OpenCloud Desktop Client synchronizes files between your computer and OpenCloud. It is available for Windows, macOS, and Linux and provides offline access, automatic synchronization, and a consistent way to work with files locally.
 
-#### Key Features
+## In this section
 
-- Synchronization of files and folders between desktop or laptop computer and OpenCloud
-- Automatic updates when changes occur
-- Offline access to important data
+- [Windows](./windows/installation.md)  
+  Install, set up, and configure the Desktop Client on Windows.
 
-<DocCardList />
+- [macOS](./macos/installation.md)  
+  Install, set up, and configure the Desktop Client on macOS.
+
+- [Linux](./linux/installation.md)  
+  Install, set up, and configure the Desktop Client on Linux.
+
+- [Common functionality](./common-functionality/multiple-accounts.md)  
+  Learn about shared features such as multiple accounts, file naming rules, conflict handling, and logging.

docs/user/files-and-folders/_category_.json

@@ -2,8 +2,7 @@
   "label": "Manage Files and Folders",
   "position": 3,
   "link": {
-    "type": "generated-index",
-    "description": "Tutorials for managing your files and folders.",
-    "slug": "user/files-and-folders/"
+    "type": "doc",
+    "id": "files-and-folders-overview"
   }
 }

docs/user/files-and-folders/index.md

@@ -0,0 +1,42 @@
+---
+sidebar_position: 0
+id: files-and-folders-overview
+title: Manage Files and Folders
+---
+
+# Manage Files and Folders
+
+Learn how to organize, manage, and review files and folders in OpenCloud.  
+This section covers common day-to-day tasks such as creating and moving content, uploading files, restoring deleted items, and reviewing file history.
+
+## In this section
+
+### Organize and manage content
+
+- [Create, rename, and move files and folders](./create-rename-move.md)  
+  Create new content, reorganize existing files and folders, and move items to a different location.
+
+- [Upload, download, and unzip content](./upload-download-unzip.md)  
+  Upload files to OpenCloud, download them to your device, or extract ZIP archives.
+
+- [Delete and restore items from the trash](./delete-restore.md)  
+  Remove files and folders and restore them later if needed.
+
+### Find and classify content
+
+- [Search for files and content](./search.md)  
+  Find files by name or search within their content.
+
+- [Add and remove tags](./tags.md)  
+  Use tags to organize files and folders and make them easier to find.
+
+- [Create shortcuts to files or web links](./shortcut.md)  
+  Add shortcuts to frequently used files or external websites for quicker access.
+
+### Review file history and activity
+
+- [View file versions and activity history](./versions.md)  
+  Review earlier file versions and track how a file has changed over time.
+
+- [Inspect file activity](./activity.md)  
+  See which actions were performed on a file or folder and who made the changes.

docs/user/general/index.md

@@ -2,15 +2,22 @@
 title: Web User Interface and Navigation
 ---
 
-import DocCardList from '@theme/DocCardList';
+# Web User Interface and Navigation
 
-The Web Client is the primary interface of OpenCloud.  
-It provides full access through the browser without requiring any additional software installation.
+The Web Client is the main interface of OpenCloud and provides full access through the browser without requiring any additional software.
 
-#### Key Features
+This section explains the main areas of the interface and shows how to navigate the Web Client, adjust the file list, and personalize your account settings.
 
-- File Management: Create, upload, edit, share, and organize files and folders
-- Space and User/Group Management
-- Collabora Online for real-time collaborative document editing
+## In this section
 
-<DocCardList />
+- [Overview](./overview.md)  
+  Get familiar with the main areas of the Web Client, including the sidebar, top bar, file list, and action areas.
+
+- [Account Settings](./account-settings.md)  
+  Manage your profile, preferences, avatar, calendar access, GDPR export, and app tokens.
+
+- [Customize the file list](./file-list-adjustments.md)  
+  Adjust how files are displayed, including hidden files, file extensions, pagination, and tile size.
+
+- [View modes](./view-modes.md)  
+  Switch between table, condensed, and tile views to change how the file list is displayed.

docs/user/index.md

@@ -19,74 +19,77 @@ import OcLogoLilac from '/static/img/oc-logo-lilac.svg';
 
 ## Welcome to the OpenCloud knowledge base
 
-Here you will find all the important information to successfully take the first steps in OpenCloud, to be able to solve
-technical problems flexibly yourself and to be able to answer frequently asked questions.
+This documentation helps you get started with OpenCloud, understand its main features, and find guidance for everyday tasks, administration, and troubleshooting.
 
 ## What is OpenCloud?
 
-OpenCloud is the file sharing and collaboration solution of the Heinlein Group.
+OpenCloud is a file sharing and collaboration platform developed by the [Heinlein Group](https://www.heinlein.group/). It helps teams store, organize, share, and collaborate on files across different devices and use cases.
 
-Through intelligent file management and a strong open source community, files become valuable resources, effectively structured and usable in the long term. With flexible data rooms and intelligent access rights, teams can access and work together on data anytime, anywhere without barriers, but with a lot of productivity.
+You can access OpenCloud in different ways, depending on your workflow:
 
-OpenCloud can be accessed in different ways, depending on the device and use case:
+- The [Web Client](./general/) provides full access to OpenCloud features directly in the browser, including file management, collaboration features, and administration options based on your permissions.
+- The [Desktop Client](./desktop-client/) synchronizes files between OpenCloud and your local computer for offline work and automatic updates.
+- The [iOS App](./ios-app/) provides convenient access to files and essential actions on iPhone and iPad.
+- The [Android App](./android-app/) provides convenient access to files and essential actions on Android devices.
+- [Collabora in OpenCloud](./collabora) provides browser-based document editing and real-time collaboration for supported office files stored in OpenCloud.
 
-- The ["Web Client"](./general/) provides full access to all OpenCloud features directly in the browser. It allows file management, user and space administration, and online collaboration via Collabora.
+Each client and integration is designed for a specific use case: the Web Client for full-featured browser access, the Desktop Client for local synchronization, the mobile apps for mobile access and everyday tasks, and Collabora Online for browser-based document editing and collaboration.
 
-- The ["Desktop Client"](./desktop-client/) synchronizes files between the OpenCloud and a local computer, enabling offline work and automatic updates.
+## Administration and deployment
 
-- The Mobile Apps for ["iOS"](./ios-app/) and ["Android"](./android-app/) allow quick access to files and basic management functions while on the go.
+If you want to install, set up, or manage your own OpenCloud environment, see the [Admin documentation](../admin/) and the [Getting Started](../admin/getting-started/) section.
 
-Each client is designed for a specific workflow:
-the Web Client for full-featured online use, the Desktop Client for local synchronization, and the Mobile Apps for mobile productivity.
+## Documentation versions
 
-## How can I use OpenCloud?
+This documentation is versioned so you can find the information that matches your OpenCloud version.
 
-Instructions on how to install and set up your own OpenCloud can be found in the ["Admin" Documentation](../admin/) under ["Getting-Started"](../admin/getting-started/)
+- **Rolling version**  
+  Reflects the current development state. Changes are added continuously, but some features may not yet be fully documented.
 
-## Documentation Versions
+- **Stable release versions**  
+  Provide documentation for officially released versions. These versions are reviewed and remain unchanged after publication.
 
-Our documentation is versioned to ensure you always find the right information for your software version.
+You can switch between the Rolling version and specific release versions using the version menu in the top-right corner.
 
-- Rolling Version: Reflects the current development state. Changes are continuously added, but the documentation may be incomplete, as new features might not yet be documented. Ideal if you are using a pre-release or development build.
-- Stable Release Versions: Documentation for officially released versions — frozen, reviewed, and unchanged since publication.
+## Explore the documentation
 
-You can switch between the Rolling version and specific Release versions using the version menu in the top right corner.
-Through intelligent file management and a strong open source community, files become valuable resources — effectively structured and usable in the long term. With flexible data rooms and intelligent access rights, teams can access and work together on data anytime, anywhere without barriers, but with a lot of productivity.
+### Apps
 
-## Table of contents
+- [OpenCloud Desktop Client](./desktop-client/)  
+  Learn how to install, set up, and use the Desktop Client.
 
-### [User Interface and Navigation](./general/)
+- [OpenCloud iOS App](./ios-app/)  
+  Find guidance for using OpenCloud on iPhone and iPad.
 
-Here you will find general information about account settings, customizations and view modes.
+- [OpenCloud Android App](./android-app/)  
+  Find guidance for using OpenCloud on Android devices.
 
-### [Manage Files and Folders](./files-and-folders/)
+### Web and editing
 
-Here you will find information about the management of files and folders.
+- [User Interface and Navigation](./general/)  
+  Learn how to navigate the Web Client, adjust account settings, and customize the interface.
 
-### [Share Files and Folders](./sharing/)
+- [Collabora Online](./collabora)  
+  Get an overview of the document editing and collaboration features available through Collabora Online in OpenCloud.
 
-Here you will find information on how to share files and folders.
+- [Manage Files and Folders](./files-and-folders/)  
+  Find guidance for creating, organizing, moving, deleting, and restoring files and folders.
 
-### [Working in Teams with Spaces](./spaces/)
+- [Share Files and Folders](./sharing/)  
+  Learn how to share content internally, create public links, and use File Drop.
 
-Here you will find information for dealing with Spaces.
+- [Working in Teams with Spaces](./spaces/)  
+  Understand how to use Spaces to organize shared work and collaborate with teams.
 
-### [OpenCloud Desktop](./desktop-client/)
+### Administration
 
-Here you will find information on how to install and set up the desktop client.
+- [Roles](./roles/)  
+  Learn about user roles, Space roles, and share permissions in OpenCloud.
 
-### [OpenCloud iOS App](./ios-app/)
+- [Administration of OpenCloud](./admin/)  
+  Explore administration features such as settings, app tokens, and WebDAV access.
 
-Here you will find information about the OpenCloud iOS App.
+### Help
 
-### [Roles](./roles/)
-
-Here you will find information about the different roles that can be assigned.
-
-### [Administration of OpenCloud](./admin/)
-
-Here you will find information on what options admins have and how you can use them.
-
-### [Common Issues and Help](./common-issues)
-
-Here you will find information on common issues and help on how to solve them.
+- [Common Issues and Help](./common-issues)  
+  Find solutions for common problems and answers to frequently asked questions.