Merge pull request #41 from Laravel-Lang/patch/2024-07-07/03-02

Added information about the new functionality of the Routes package

Author: andrey-helldar

docs/snippets/packages-routes-auto-locale.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+route('localized.show', ['bar' => 'show', 'locale' => app()->getLocale()]);
+// https://example.com/fr/foo/show
+
+route('localized.show', ['bar' => 'show', 'locale' => 'de']);
+// https://example.com/de/foo/show
+
+route('localized.show', ['bar' => 'show']);
+// https://example.com/fr/foo/show
+
+route('localized.show', ['bar' => 'show', 'locale' => 'de']);
+// https://example.com/de/foo/show

docs/topics/packages-routes.topic

@@ -37,7 +37,7 @@
     <chapter title="Usage" id="usage">
         <link-summary>Usage information for the %repository-title-routes% package</link-summary>
 
-        <include from="library-models.topic" element-id="video-usage"/>
+        <include from="library-models.topic" element-id="video-usage" />
 
         <p>
             Let's say an application has two localizations installed - French and German.
@@ -530,6 +530,24 @@
                 of the <code>%config-filename%</code> file.
             </p>
 
+            <note>
+                <p>
+                    Since version <a href="https://github.com/Laravel-Lang/routes/releases/tag/1.4.0">1.4</a>,
+                    when calling a localized route name, such as
+                    <code>route('localized.show', ['bar' => 'show'])</code>,
+                    there is no need to specify the current localization code.
+                </p>
+
+                <tabs>
+                    <tab title="After">
+                        <code-block lang="php" src="packages-routes-auto-locale.php" include-lines="11-15" />
+                    </tab>
+                    <tab title="Before">
+                        <code-block lang="php" src="packages-routes-auto-locale.php" include-lines="5-9" />
+                    </tab>
+                </tabs>
+            </note>
+
             <chapter title="Examples" id="via_localization_group_examples">
                 <tabs>
                     <tab title="Default locale">