From 15144def3c83bafc8c0397f2a0e1f8685c448eab Mon Sep 17 00:00:00 2001
From: lukinovec <lukinovec@gmail.com>
Date: Thu, 20 Aug 2026 11:58:31 +0200
Subject: [PATCH] Update tenancy.filesystem config docblocks

Briefly document the root_override placeholders, make the links point to v4 docs instead of the v3 ones. Also in the url_override comments, mention that local disks must have a valid root in order for the override to work correctly.
---
 assets/config.php | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/assets/config.php b/assets/config.php
index 96a0aeca..d37d1d6b 100644
--- a/assets/config.php
+++ b/assets/config.php
@@ -321,7 +321,7 @@ return [
 
     /**
      * Filesystem tenancy config. Used by FilesystemTenancyBootstrapper.
-     * https://tenancyforlaravel.com/docs/v3/tenancy-bootstrappers/#filesystem-tenancy-boostrapper.
+     * https://v4.tenancyforlaravel.com/bootstrappers/filesystem.
      */
     'filesystem' => [
         /**
@@ -337,10 +337,16 @@ return [
         /**
          * Use this for local disks.
          *
-         * See https://tenancyforlaravel.com/docs/v3/tenancy-bootstrappers/#filesystem-tenancy-boostrapper
+         * The override can use these placeholders:
+         * - %storage_path% -- the tenant's storage directory. Note that this is resolved
+         *   by the bootstrapper, so it doesn't depend on the 'suffix_storage_path' config below.
+         * - %original_storage_path% -- the central storage directory.
+         * - %tenant% -- the tenant's key.
+         *
+         * See https://v4.tenancyforlaravel.com/bootstrappers/filesystem
          */
         'root_override' => [
-            // Disks whose roots should be overridden after storage_path() is suffixed.
+            // Disks whose roots should be overridden in tenant context.
             'local' => '%storage_path%/app/',
             'public' => '%storage_path%/app/public/',
         ],
@@ -357,7 +363,8 @@ return [
          * Use `php artisan tenants:link` to create a symbolic link from the tenant's storage to its public directory.
          */
         'url_override' => [
-            // Note that the local disk you add must exist in the tenancy.filesystem.disks config
+            // Note that the local disk you add must exist in the tenancy.filesystem.disks config,
+            // and it must have a non-falsy root (i.e., not null or empty string).
             'public' => 'public-%tenant%',
         ],