Repository: flutter
Issue: [go_router] Clarification on Route Ordering with Multiple Matches: Follow-Up to Issue #106851
Labels: d: api docs,d: examples,package,P3,p: go_router,team-go_router,triaged-go_router

### What package does this bug report belong to?

go_router

### What target platforms are you seeing this bug on?

Android, iOS, Web, macOS, Linux, Windows

### Have you already upgraded your packages?

Yes

### Dependency versions

<details><summary>pubspec.lock</summary>

```lock
go_router: ^14.1.2
```

</details>


### Steps to reproduce

In Issue #106851 (https://github.com/flutter/flutter/issues/106851), there was a promise of a documentation update about the importance of route order. Despite this, I cannot find any new information on the topic.

### Expected results

Please consider extending the documentation to include one of the following clarifications:
1. The most specific route is matched.
2. The first route in the list is matched.
3. It remains undocumented, but currently, the first route in the list is being matched. As this is an undocumented feature, it should not be relied upon, and GoRouter should warn users about this behavior.

### Actual results

No information found.

### Code sample

<details open><summary>Code sample</summary>

Practically I am not sure if it is safe to use
```dart
        routes: [
          GoRoute(
            path: 'specific_path',
            builder: (context, state) {
              return Page1();
            },
          ),
          GoRoute(
            path: ':id',
            builder: (context, state) {
              return Page2();
            },
          ),
```
where I `path: ':id',` can also match `path: 'specific_path',`.

</details>


### Screenshots or Videos

<details open>
<summary>Screenshots / Video demonstration</summary>

[Upload media here]

</details>


### Logs

<details open><summary>Logs</summary>

```console
[Paste your logs here]
```

</details>


### Flutter Doctor output

<details open><summary>Doctor output</summary>

```console
[✓] Flutter (Channel stable, 3.22.0, on macOS 14.3 23D5033f darwin-arm64
    (Rosetta), locale en-US)
    • Flutter version 3.22.0 on channel stable at
      /Users/filipcizmar/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 5dcb86f68f (6 weeks ago), 2024-05-09 07:39:20
      -0500
    • Engine revision f6344b75dc
    • Dart version 3.4.0
    • DevTools version 2.34.3

[✓] Android toolchain - develop for Android devices (Android SDK version
    34.0.0)
    • Android SDK at /Users/filipcizmar/Library/Android/sdk
    • Platform android-34, build-tools 34.0.0
    • ANDROID_HOME = /Users/filipcizmar/Library/Android/sdk
    • Java binary at: /Applications/Android
      Studio.app/Contents/jbr/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build
      17.0.9+0-17.0.9b1087.7-11185874)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 15.4)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 15F31d
    • CocoaPods version 1.14.3

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google
      Chrome

[✓] Android Studio (version 2023.2)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build
      17.0.9+0-17.0.9b1087.7-11185874)

[✓] VS Code (version 1.90.1)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.90.0

[✓] Connected device (5 available)            
    • Filip‘s iPhone (mobile)         • 00008130-000160A43041401C • ios
      • iOS 17.5.1 21F90
    • Filip‘s iPad (mobile)           • 00008103-0001684E0284C01E • ios
      • iOS 18.0 22A5282m
    • macOS (desktop)                 • macos                     •
      darwin-arm64   • macOS 14.3 23D5033f darwin-arm64 (Rosetta)
    • Mac Designed for iPad (desktop) • mac-designed-for-ipad     •
      darwin         • macOS 14.3 23D5033f darwin-arm64 (Rosetta)
    • Chrome (web)                    • chrome                    •
      web-javascript • Google Chrome 126.0.6478.62

[✓] Network resources
    • All expected network resources are available.

• No issues found!
```

</details>