fix: added the paragraph above note and made the changes to additional options as per config

Author: yemkareems

admin_manual/configuration_files/file_versioning.rst

@@ -21,28 +21,46 @@ The Versions app never uses more than 50% of the user's currently available
 free space. If the stored versions exceed this limit, Nextcloud deletes the 
 oldest file versions until it meets the disk space limit again.
 
+The ``versions_retention_obligation`` setting behaves slightly differently
+depending on whether version expiration is triggered by an *explicit job run*
+(for example, via ``occ versions:expire`` or a scheduled background job) or by
+*automatic expiry*.
+
+Explicit job-based expiration is *strict* and adheres closely to the configured
+``versions_retention_obligation``.
+
+Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
+necessary to maintain adequate free storage space.
+
+This distinction can lead to different results depending on whether cleanup is
+performed automatically or manually.
+
 .. note:: Versions named by a user will never be deleted.
 
 You may alter the default pattern in ``config.php``. The default setting is 
 ``auto``, which sets the default pattern::
 
  'versions_retention_obligation' => 'auto',
 
+Default setting. Keeps files and folders in the trash bin for at least **30** days.
+Then, **if space is needed**, deletes trashed files anytime after that.
+
 Additional options are:
 
-* ``D, auto``   
-    Keep versions at least for D days, apply expiration rules to all versions 
-    that are older than D days
+* ``D1, auto``
+    Keeps files and folders in the trash bin for at least **D1** days.
+    Then, **if space is needed**, deletes trashed files anytime after that.
 
-* ``auto, D``   
-    Delete all versions that are older than D days automatically, delete other 
-    versions according to expiration rules
+* ``auto, D2``
+    **If space is needed**, deletes trashed files anytime.
+    After **D2** days, delete all trashed files automatically.
 
 * ``D1, D2``    
-    Keep versions for at least D1 days and delete when they exceed D2 days.
+    Keeps files and folders in the trash bin for at least **D1** days.
+    Then, after **D2** days, delete all trashed files automatically.
 
 * ``disabled``  
-    Disable the Versions app; no old file versions will be deleted.
+    Trash bin auto clean is disabled, files and folders will be kept forever.
 
 Background job
 --------------
@@ -54,22 +72,4 @@ Deactivate background job: ``occ config:app:set --value=no files_versions backgr
 
 Activate background job: ``occ config:app:delete files_versions background_job_expire_versions``
 
-Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)
-
-.. note::
-
-*Deviations in behavior: “job run” vs “auto-expiry”*
-
-The ``versions_retention_obligation`` setting behaves slightly differently
-depending on whether version expiration is triggered by an *explicit job run*
-(for example, via ``occ versions:expire`` or a scheduled background job) or by
-*automatic expiry*.
-
-Explicit job-based expiration is *strict* and adheres closely to the configured
-``versions_retention_obligation``.
-
-Auto-expiry follows the same retention principles but may apply them more flexibly, allowing minor deviations when
-necessary to maintain adequate free storage space.
-
-This distinction can lead to different results depending on whether cleanup is
-performed automatically or manually.
+Expire versions: ``occ versions:expire`` or ``occ versions:expire --quiet`` (without the progress bar)