Improve

Author: simonhamp

resources/views/docs/mobile/2/the-basics/assets.md

@@ -27,22 +27,27 @@ Note that the `storage_path()` helper points to a location _outside_ of your Lar
 
 </aside>
 
-## Pro tip! 
+## Public files
 
-Use the `asset()` helper method to access files in the public directory. Additionally, update your filesystems.php public url to the following:
+If your application receives files from the user — either generated by your application or imported from elsewhere,
+such as their photo gallery — you may wish to render these to the web view so they can be played or displayed as part
+of your app.
 
-```php
-'public' => [
-    'driver' => 'local',
-    'root' => storage_path('app/public'),
-    'url' => env('APP_URL').'/_assets/storage',
-    'visibility' => 'public',
-    'throw' => false,
-    'report' => false,
-],
-```
+For this to work, they must be in the `public` directory. But you may also wish to persist these files across app
+updates. For this reason, they are stored outside of the `public` directory in a persistent storage location and this
+folder is symlinked to `public/storage`.
+
+You can then access these files using the `mobile_public` disk:
 
-Now you can use Laravel's Storage facade to display media in the webview, like so: 
 ```php
-Storage::disk('public')->url('/file.jpg)
+Storage::disk('mobile_public')->url('user_content.jpg');
 ```
+
+<aside>
+
+#### Pro Tip!
+
+Set `FILESYSTEM_DISK=mobile_public` in your `.env` when building your app so you can avoid having to explicitly change
+the disk on mobile.
+
+</aside>