Update Screenshots and Add Documentation for Expert Settings (#61)

Author: mindmonk

source/desktop/accessing-vaults.rst

@@ -70,9 +70,6 @@ Locking a vault
 
 To lock a vault, simply click ``Lock`` and the virtual drive will disappear or render empty. Your files remain encrypted at the vault's location.
 
-.. image:: ../img/desktop/vault-detail-locked.png
-    :alt: Cryptomator window showing an locked vault
-
 Locate Encrypted File
 ---------------------
 

source/desktop/adding-vaults.rst

@@ -9,11 +9,11 @@ You will be presented with two options when adding a vault:
 .. image:: ../img/desktop/create-or-open-vault.png
     :alt: Create a new or open an existing vault
 
-.. |CreateVault| replace:: ``New Vault...``
-.. _CreateVault: ./adding-vaults.html#create-a-new-vault
+.. |CreateVault| replace:: ``Create New Vault...``
+.. _CreateVault: #create-a-new-vault
 
-.. |OpenVault| replace:: ``Existing Vault...``
-.. _OpenVault: ./adding-vaults.html#open-an-existing-vault
+.. |OpenVault| replace:: ``Open Existing Vault...``
+.. _OpenVault: #open-an-existing-vault
 
 
 .. _desktop/adding-vaults/create-a-new-vault:
@@ -23,8 +23,7 @@ You will be presented with two options when adding a vault:
 Create a New Vault
 ------------------
 
-If you chose to create a new vault, the wizard will guide you through a simple 5-step vault creation process.
-
+If you chose to create a new vault, the wizard will guide you through a simple 6-step vault creation process.
 
 .. _desktop/adding-vaults/1.-choose-a-name:
 
@@ -36,7 +35,6 @@ Start by choosing a name for your vault.
 .. image:: ../img/desktop/add-vault-1.png
     :alt: Choosing "My first Vault" as a vault name
 
-
 .. _desktop/adding-vaults/2.-choose-a-storage-location:
 
 2. Choose a Storage Location
@@ -59,10 +57,41 @@ You need to install the sync software of your cloud storage provider to sync you
 .. image:: ../img/desktop/add-vault-2.png
     :alt: Choosing Dropbox as a storage location for my vault
 
+.. _desktop/adding-vaults/3.-expert-settings:
+
+3. Expert Settings
+^^^^^^^^^^^^^^^^^^^^^
+
+The **Expert Settings** screen provides advanced configuration options for your vault. These settings are intended for users who require greater control over how their data is encrypted and stored.
+
+.. note::
+
+   Expert Settings are optional and should only be adjusted if you understand their implications.
+
+**Enable Expert Settings**
+
+To access expert settings, toggle the **Enable Expert Settings** switch. Once enabled, additional configuration options will be available.
+
+**Maximum Length of Encrypted File Names**
+
+One of the primary expert settings allows you to configure the maximum length of encrypted file names. This setting controls the degree of *name shortening* applied to file names during encryption, which is critical for compatibility with filesystems that have strict length limits.
+
+- **Default Behavior**: Cryptomator automatically shortens file names to comply with filesystem constraints.
+- **Custom Configuration**: If specific requirements must be met, you can manually set the maximum allowed length for encrypted file names.
 
-.. _desktop/adding-vaults/3.-choose-a-passwords:
+Refer to :ref:`Name Shortening <security/vault/name-shortening>` for additional details.
 
-3. Choose a Password
+.. image:: ../img/desktop/add-vault-3.png
+    :alt: Expert settings
+
+.. warning::
+
+   Adjusting the maximum length of encrypted file names may affect compatibility with certain filesystems. Ensure you thoroughly test these settings before enabling them for critical data.
+
+
+.. _desktop/adding-vaults/4.-choose-a-password:
+
+4. Choose a Password
 ^^^^^^^^^^^^^^^^^^^^^
 
 Now it is time to choose a :ref:`strong password <security/best-practices/good-passwords>` for your vault.
@@ -75,7 +104,7 @@ The bar below the password field will help you estimate the strength of your pas
     This is especially important if you plan to share a vault with someone.
     Additionally, we recommend sharing passwords only over a secure channel, like PGP encypted emails, or end-to-end encrypted chat apps.
 
-.. image:: ../img/desktop/add-vault-3.png
+.. image:: ../img/desktop/add-vault-4.png
     :alt: Choose a strong password for your Cryptomator vault
 
 .. warning::
@@ -87,17 +116,17 @@ The bar below the password field will help you estimate the strength of your pas
     However, you can reset a vault's password by yourself if you have its *recovery key*.
 
 
-.. _desktop/adding-vaults/4.-show-recovery-key-(optional-step):
+.. _desktop/adding-vaults/5.-show-recovery-key-(optional-step):
 
-4. Show Recovery Key (optional step)
+5. Show Recovery Key (optional step)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 A recovery key allows you to reset your password if you ever forget it.
 
 If you chose to create a recovery key in the previous step, it will now be displayed.
 Make sure not to lose it and ideally make a hard copy of it.
 
-.. image:: ../img/desktop/add-vault-4.png
+.. image:: ../img/desktop/add-vault-5.png
     :alt: Showing the recovery key
 
 .. warning::
@@ -107,17 +136,17 @@ Make sure not to lose it and ideally make a hard copy of it.
 
 For more details, take a look at :ref:`how a recovery key works <desktop/password-and-recovery-key/reset-password>`.
 
-.. _desktop/adding-vaults/5.-done:
+.. _desktop/adding-vaults/6.-done:
 
-5. Done
+6. Done
 ^^^^^^^
 
 That's it.
 You have successfully created a new vault.
 
 You can now unlock this vault using your password and start adding files into it.
 
-.. image:: ../img/desktop/add-vault-5.png
+.. image:: ../img/desktop/add-vault-6.png
     :alt: Showing the recovery key
 
 

source/desktop/getting-started.rst

@@ -9,7 +9,7 @@ You can create new vaults (or add existing ones) using the |AddVault|_ button lo
 .. image:: ../img/desktop/empty-vault-list.png
     :alt: Empty vault list
 
-.. |AddVault| replace:: ``Add``
+.. |AddVault| replace:: ``+``
 .. _AddVault: ./adding-vaults.html
 
 .. _desktop/getting-started/tutorial-video:

source/desktop/password-and-recovery-key.rst

@@ -107,7 +107,7 @@ If the recovery key is valid, a small message will be displayed below the entere
     By design, *only* the correct recovery key is accepted. **A valid but incorrect key won't be accepted to prevent your old data from becoming inaccessible.**
 
 Finally, assign a new password to your vault.
-It is the same process as the :ref:`vault creation <desktop/adding-vaults/3.-choose-a-passwords>`, except that no new recovery key is generated.
+It is the same process as the :ref:`vault creation <desktop/adding-vaults/4.-choose-a-password>`, except that no new recovery key is generated.
 Again, please choose a :ref:`strong password <security/best-practices/good-passwords>`.
 
 Once changed, you can unlock your vault with the new password.