Add better name and documentation

Author: ValentinVignal

packages/go_router/lib/src/match.dart

@@ -219,16 +219,16 @@ abstract class RouteMatchBase with Diagnosticable {
         concatenatePaths(matchedLocation, pathLoc);
     final String newMatchedPath = concatenatePaths(matchedPath, route.path);
 
-    final String caseSensitiveNewMatchedLocation;
-    final String caseSensitiveUriPath;
+    final String newMatchedLocationToCompare;
+    final String uriPathToCompare;
     if (route.caseSensitive) {
-      caseSensitiveNewMatchedLocation = newMatchedLocation;
-      caseSensitiveUriPath = uri.path;
+      newMatchedLocationToCompare = newMatchedLocation;
+      uriPathToCompare = uri.path;
     } else {
-      caseSensitiveNewMatchedLocation = newMatchedLocation.toLowerCase();
-      caseSensitiveUriPath = uri.path.toLowerCase();
+      newMatchedLocationToCompare = newMatchedLocation.toLowerCase();
+      uriPathToCompare = uri.path.toLowerCase();
     }
-    if (caseSensitiveNewMatchedLocation == caseSensitiveUriPath) {
+    if (newMatchedLocationToCompare == uriPathToCompare) {
       // A complete match.
       pathParameters.addAll(currentPathParameter);
 
@@ -242,7 +242,7 @@ abstract class RouteMatchBase with Diagnosticable {
         ],
       };
     }
-    assert(caseSensitiveUriPath.startsWith(caseSensitiveNewMatchedLocation));
+    assert(uriPathToCompare.startsWith(newMatchedLocationToCompare));
     assert(remainingLocation.isNotEmpty);
 
     final String childRestLoc = uri.path.substring(

packages/go_router/lib/src/route.dart

@@ -438,7 +438,15 @@ class GoRoute extends RouteBase {
   /// ```
   final ExitCallback? onExit;
 
-  /// Whether the path is case sensitive or not.
+  /// Determines whether the route matching is case sensitive.
+  ///
+  /// When `true`, the path must match the specified case. For example,
+  /// a [GoRoute] with `path: '/family/:fid'` will not match `/FaMiLy/f2`.
+  ///
+  /// When `false`, the path matching is case insensitive.  The route
+  /// with `path: '/family/:fid'` will match `/FaMiLy/f2`.
+  ///
+  /// Defaults to `true`.
   final bool caseSensitive;
 
   // TODO(chunhtai): move all regex related help methods to path_utils.dart.