Update once-props.mdx

Author: pascalbaljet

v2/data-props/once-props.mdx

@@ -9,58 +9,30 @@ Some data rarely changes or is expensive to compute. Rather than resolving this
 To create a once prop, use the `Inertia::once()` method when returning your response. This method receives a callback that returns the prop data.
 
 ```php
-return Inertia::render('Settings', [
-    'countries' => Inertia::once(fn () => Country::all()),
+return Inertia::render('Billing', [
+    'plans' => Inertia::once(fn () => Plan::all()),
 ]);
 ```
 
 After the client has received this prop, subsequent requests will skip resolving the callback entirely and the prop will be excluded from the response. The client will automatically reuse the remembered value.
 
 Navigating to a page without the once prop will break the chain, and the prop will be resolved again on the next page that has it.
 
-## Sharing Once Props
-
-You may share once props globally using the `Inertia::share()` method.
-
-```php
-Inertia::share('countries', Inertia::once(fn () => Country::all()));
-```
-
-Or use the `shareOnce()` helper method.
-
-```php
-Inertia::shareOnce('countries', fn () => Country::all());
-```
-
-You may also define a dedicated `shareOnce()` method in your middleware.
-
-```php
-class HandleInertiaRequests extends Middleware
-{
-    public function shareOnce(Request $request): array
-    {
-        return [
-            'countries' => fn () => Country::all(),
-        ];
-    }
-}
-```
-
 ## Forcing a Refresh
 
 You may force a once prop to be refreshed using the `fresh()` method.
 
 ```php
-return Inertia::render('Settings', [
-    'countries' => Inertia::once(fn () => Country::all())->fresh(),
+return Inertia::render('Billing', [
+    'plans' => Inertia::once(fn () => Plan::all())->fresh(),
 ]);
 ```
 
-This method accepts a boolean, allowing you to conditionally refresh the prop.
+This method also accepts a boolean, allowing you to conditionally refresh the prop.
 
 ```php
-return Inertia::render('Settings', [
-    'preferences' => Inertia::once(fn () => $user->preferences)->fresh($user->wasChanged()),
+return Inertia::render('Billing', [
+    'plans' => Inertia::once(fn () => Plan::all())->fresh($condition),
 ]);
 ```
 
@@ -92,6 +64,40 @@ return Inertia::render('Team/Invite', [
 
 Both pages share the same underlying data because they use the same custom key, so the prop is only resolved for whichever page you visit first.
 
+## Sharing Once Props
+
+You may share once props globally using the `Inertia::share()` method.
+
+```php
+Inertia::share('countries', Inertia::once(fn () => Country::all()));
+```
+
+Or use the `shareOnce()` helper method.
+
+```php
+Inertia::shareOnce('countries', fn () => Country::all());
+```
+
+You may also chain `as()`, `fresh()`, and `until()` onto this method.
+
+```php
+Inertia::shareOnce('countries', fn () => Country::all())->until(3600);
+```
+
+You may also define a dedicated `shareOnce()` method in your middleware.
+
+```php
+class HandleInertiaRequests extends Middleware
+{
+    public function shareOnce(Request $request): array
+    {
+        return [
+            'countries' => fn () => Country::all(),
+        ];
+    }
+}
+```
+
 ## Prefetching
 
 Once props work with [prefetching](/v2/data-props/prefetching). The client automatically includes any remembered once props in prefetched responses, so navigating to a prefetched page will already have the once props available.
@@ -104,7 +110,7 @@ The `once()` modifier may be chained onto [deferred](/v2/data-props/deferred-pro
 
 ```php
 return Inertia::render('Dashboard', [
-    'countries' => Inertia::defer(fn () => Country::all())->once(),
+    'permissions' => Inertia::defer(fn () => Permission::all())->once(),
     'activity' => Inertia::merge(fn () => $user->recentActivity())->once(),
     'categories' => Inertia::optional(fn () => Category::all())->once(),
 ]);