diff --git a/assets/config.php b/assets/config.php
index 3ed61106..2e75f58c 100644
--- a/assets/config.php
+++ b/assets/config.php
@@ -119,7 +119,9 @@ return [
         ],
 
         /*
-         * To enable tenant-aware Storage::disk()->url(), override a local driver disk's default URL with a URL that has %tenant_id%.
+         * Tenant-aware Storage::disk()->url() can be enabled for specific local disks here
+         * by mapping the disk's name to a name with '%tenant_id%' (this will be used as the public name of the disk).
+         * Doing that will override the disk's default URL with a URL containing the current tenant's key.
          *
          * For example, Storage::disk('public')->url('') will return https://your-app.test/storage/ by default.
          * After adding 'public' => 'public-%tenant_id%' to 'url_override',
@@ -129,6 +131,8 @@ return [
          */
         'url_override' => [
             // Note that the local disk you add must exist in the tenancy.filesystem.root_override config
+            // todo@v4 Rename %tenant_id% to %tenant_key%
+            // todo@v4 Rename url_override to something that describes the config key better
             'public' => 'public-%tenant_id%',
         ],