Web dav 05 26 (#887)

* app tokens new screenshots and text adjustments

* webDAV new screenshots and text adjustments

Author: Svanvith

docs/user/admin/img/webdav/preferences.png

@@ -8,45 +8,32 @@ draft: false
 
 # Connect to a Space via WebDAV
 
-With WebDAV, you can connect OpenCloud Spaces and Folders as network drives on your device and manage your files directly from your file manager — without using the browser.
+With WebDAV, you can connect OpenCloud Spaces and folders as network drives on your device and manage your files directly from your file manager without using the browser.
 
 ## Prerequisites
 
-- A valid OpenCloud account with WebDAV information enabled in the preferences
-- Access to a resource in OpenCloud, either a Space, a Folder or the root of your account
-- A WebDAV client (e.g. built-in OS support or [Mountain Duck](https://mountainduck.io/))
-- (Optional but recommended) An App Token  
+- A valid OpenCloud account with WebDAV information enabled in the account settings
+- Access to a resource in OpenCloud, either a Space, a folder, or the root of your account
+- A WebDAV client, for example built-in OS support or [Mountain Duck](https://mountainduck.io/)
+- If your WebDAV client requires it, an App Token  
   → [How to create an App Token](./app-tokens)
 
 ## Step-by-Step Guide
 
-### Enable WebDAV Info in the UI
+### Enable WebDAV info in the UI
 
-To display WebDAV information for your Spaces:
+To display WebDAV information for a Space:
 
-- Go to Account Settings
-- Enable "Show WebDAV info in details view"
+- Open Account Settings.
+- Enable "Show WebDAV info in details view".
 
   <img src={require("./img/webdav/preferences.png").default} alt="Enable WebDAV info" width="1920"/>
 
-### Create an App Token (if required)
-
-Some WebDAV clients (especially non-OIDC compatible ones like Mountain Duck) require an App Token for authentication.
-
-:::note
-We recommend using an App Token instead of your password for better security.
-:::
-
-- Go to Settings > App Tokens
-- Click "+ New", give it a name, and set an expiration date
-- Copy the token immediately – it will only be shown once  
-  → [See App Token Guide](./app-tokens#copy-the-app-token)
-
 ### Get the WebDAV URL
 
-Open the info panel of the resource you want to access in the OpenCloud Web Interface.
+Open the info panel of the Space, folder, or account root you want to access in the OpenCloud web interface.
 
-You’ll see a section labeled WebDAV — copy the full WebDAV URL. It looks like:
+You will see a section labeled WebDAV. Copy the full WebDAV URL. It looks like this:
 
 `https://cloud.example.com/remote.php/dav/spaces/12345678-abcd-efgh-ijkl-987654321000/`
 
@@ -57,36 +44,33 @@ You’ll see a section labeled WebDAV — copy the full WebDAV URL. It looks lik
 Now connect your device using the WebDAV URL:
 
 - Username: your OpenCloud username
-- Password: your App Token (or password, if allowed)
+- Password: your OpenCloud password or an App Token, depending on your setup
 
 You can use various clients depending on your operating system:
 
 ## Windows
 
-- Open File Explorer → Click on “This PC” → Choose “Map network drive”
-- Enter the WebDAV URL
-- Authenticate with username and App Token
+- Open File Explorer.
+- Click on "This PC" and choose "Map network drive".
+- Enter the WebDAV URL.
+- Authenticate with your username and password or App Token.
 
 ## macOS
 
-- In Finder, choose “Go” > “Connect to Server…”
-- Enter the WebDAV URL
-- Login with your credentials or App Token
+- In Finder, choose "Go" > "Connect to Server...".
+- Enter the WebDAV URL.
+- Log in with your credentials or App Token.
 
 ## Linux
 
-- Use your file manager’s “Connect to Server” option
-- Format the URL as:  
+- Use your file manager’s "Connect to Server" option.
+- Format the URL as:
   `davs://cloud.example.com/remote.php/dav/spaces/<SPACE-ID>/`
 
 :::note
-Once connected, your Space will behave like a normal folder.
-:::
-
-:::note
+Once connected, your Space behaves like a normal folder.
 
-- If your WebDAV client supports OIDC, you may not need an App Token
-- Always use `https://` to ensure secure access
-- App Tokens can be revoked anytime via your account settings
+- If your client supports OIDC, you may not need an App Token.
+- Use `https://` to ensure secure access.
 
   :::

docs/user/admin/img/webdav/webdav-url.png

@@ -8,45 +8,32 @@ draft: false
 
 # Connect to a Space via WebDAV
 
-With WebDAV, you can connect OpenCloud Spaces and Folders as network drives on your device and manage your files directly from your file manager — without using the browser.
+With WebDAV, you can connect OpenCloud Spaces and folders as network drives on your device and manage your files directly from your file manager without using the browser.
 
 ## Prerequisites
 
-- A valid OpenCloud account with WebDAV information enabled in the preferences
-- Access to a resource in OpenCloud, either a Space, a Folder or the root of your account
-- A WebDAV client (e.g. built-in OS support or [Mountain Duck](https://mountainduck.io/))
-- (Optional but recommended) An App Token  
+- A valid OpenCloud account with WebDAV information enabled in the account settings
+- Access to a resource in OpenCloud, either a Space, a folder, or the root of your account
+- A WebDAV client, for example built-in OS support or [Mountain Duck](https://mountainduck.io/)
+- If your WebDAV client requires it, an App Token  
   → [How to create an App Token](./app-tokens)
 
 ## Step-by-Step Guide
 
-### Enable WebDAV Info in the UI
+### Enable WebDAV info in the UI
 
-To display WebDAV information for your Spaces:
+To display WebDAV information for a Space:
 
-- Go to Account Settings
-- Enable "Show WebDAV info in details view"
+- Open Account Settings.
+- Enable "Show WebDAV info in details view".
 
   <img src={require("./img/webdav/preferences.png").default} alt="Enable WebDAV info" width="1920"/>
 
-### Create an App Token (if required)
-
-Some WebDAV clients (especially non-OIDC compatible ones like Mountain Duck) require an App Token for authentication.
-
-:::note
-We recommend using an App Token instead of your password for better security.
-:::
-
-- Go to Settings > App Tokens
-- Click "+ New", give it a name, and set an expiration date
-- Copy the token immediately – it will only be shown once  
-  → [See App Token Guide](./app-tokens)
-
 ### Get the WebDAV URL
 
-Open the info panel of the resource you want to access in the OpenCloud Web Interface.
+Open the info panel of the Space, folder, or account root you want to access in the OpenCloud web interface.
 
-You’ll see a section labeled WebDAV — copy the full WebDAV URL. It looks like:
+You will see a section labeled WebDAV. Copy the full WebDAV URL. It looks like this:
 
 `https://cloud.example.com/remote.php/dav/spaces/12345678-abcd-efgh-ijkl-987654321000/`
 
@@ -57,36 +44,33 @@ You’ll see a section labeled WebDAV — copy the full WebDAV URL. It looks lik
 Now connect your device using the WebDAV URL:
 
 - Username: your OpenCloud username
-- Password: your App Token (or password, if allowed)
+- Password: your OpenCloud password or an App Token, depending on your setup
 
 You can use various clients depending on your operating system:
 
 ## Windows
 
-- Open File Explorer → Click on “This PC” → Choose “Map network drive”
-- Enter the WebDAV URL
-- Authenticate with username and App Token
+- Open File Explorer.
+- Click on "This PC" and choose "Map network drive".
+- Enter the WebDAV URL.
+- Authenticate with your username and password or App Token.
 
 ## macOS
 
-- In Finder, choose “Go” > “Connect to Server…”
-- Enter the WebDAV URL
-- Login with your credentials or App Token
+- In Finder, choose "Go" > "Connect to Server...".
+- Enter the WebDAV URL.
+- Log in with your credentials or App Token.
 
 ## Linux
 
-- Use your file manager’s “Connect to Server” option
-- Format the URL as:  
+- Use your file manager’s "Connect to Server" option.
+- Format the URL as:
   `davs://cloud.example.com/remote.php/dav/spaces/<SPACE-ID>/`
 
 :::note
-Once connected, your Space will behave like a normal folder.
-:::
-
-:::note
+Once connected, your Space behaves like a normal folder.
 
-- If your WebDAV client supports OIDC, you may not need an App Token
-- Always use `https://` to ensure secure access
-- App Tokens can be revoked anytime via your account settings
+- If your client supports OIDC, you may not need an App Token.
+- Use `https://` to ensure secure access.
 
   :::