Merge branch 'master' into fix/incorrect-tile-keys

Author: JaffaKetchup

.github/workflows/branch.yml

@@ -62,7 +62,7 @@ jobs:
         run: flutter test -r expanded --coverage
       - name: Run Codecov
         if: ${{ matrix.sdk == '' }}
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
@@ -94,7 +94,7 @@ jobs:
         run: flutter build apk --dart-define=COMMIT_SHA=${{ github.sha }} --dart-define=flutter.flutter_map.unblockOSM="${{ secrets.UNBLOCK_OSM }}"
       - name: Archive Artifact
         if: ${{ matrix.sdk == '' }}
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: apk-build
           path: example/build/app/outputs/apk/release
@@ -129,7 +129,7 @@ jobs:
         working-directory: .
       - name: Archive Artifact
         if: ${{ matrix.sdk == '' }}
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: exe-build
           path: windowsTemp/WindowsApplication.exe
@@ -156,7 +156,7 @@ jobs:
       - name: Build Web Application
         run: flutter build web --wasm --dart-define=COMMIT_SHA=${{ github.sha }} --dart-define=flutter.flutter_map.unblockOSM="${{ secrets.UNBLOCK_OSM }}"
       - name: Archive Artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: ${{ matrix.sdk == '' }}
         with:
           name: web-build

.github/workflows/issue-comment.yml

@@ -12,7 +12,7 @@ jobs:
     steps:
       - name: Check labels of issue
         id: check_labels
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -42,7 +42,7 @@ jobs:
       # action removes the label when the automatic reminder message gets sent.
       - name: Remove `waiting for user response` label if exists
         if: steps.check_labels.outputs.result == 'true'
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |

.github/workflows/master.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Run Tests with Coverage
         run: flutter test -r expanded --coverage
       - name: Run Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         env:
           CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
@@ -53,7 +53,7 @@ jobs:
       - name: Build Android Application
         run: flutter build apk --dart-define=COMMIT_SHA=${{ github.sha }} --dart-define=flutter.flutter_map.unblockOSM="${{ secrets.UNBLOCK_OSM }}"
       - name: Archive Artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: apk-build
           path: example/build/app/outputs/apk/release
@@ -82,7 +82,7 @@ jobs:
         run: iscc "windowsApplicationInstallerSetup.iss"
         working-directory: .
       - name: Archive Artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: exe-build
           path: windowsTemp/WindowsApplication.exe
@@ -107,7 +107,7 @@ jobs:
       - name: Build Web Application
         run: flutter build web --wasm --dart-define=COMMIT_SHA=${{ github.sha }} --dart-define=flutter.flutter_map.unblockOSM="${{ secrets.UNBLOCK_OSM }}"
       - name: Archive Artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: web-build
           path: example/build/web

lib/src/layer/tile_layer/tile_layer.dart

@@ -21,12 +21,11 @@ part 'retina_mode.dart';
 part 'tile_error_evict_callback.dart';
 part 'wms_tile_layer_options.dart';
 
-/// Describes the needed properties to create a tile-based layer. A tile is an
+/// Describes the needed properties to create a raster tile layer. A tile is an
 /// image bound to a specific geographical position.
 ///
-/// You should read up about the options by exploring each one, or visiting
-/// https://docs.fleaflet.dev/usage/layers/tile-layer. Some are important to
-/// avoid issues.
+/// Read the [online documentation](https://docs.fleaflet.dev/layers/tile-layer)
+/// to get started by following the recommended setup.
 @immutable
 class TileLayer extends StatefulWidget {
   /// The URL template is a string that contains placeholders, which, when filled

lib/src/map/controller/map_controller.dart

@@ -6,18 +6,15 @@ import 'package:flutter_map/src/map/inherited_model.dart';
 import 'package:flutter_map/src/misc/move_and_rotate_result.dart';
 import 'package:latlong2/latlong.dart';
 
-/// Controller to programmatically interact with [FlutterMap], such as
-/// controlling it and accessing some of its properties.
+/// Controller to programmatically interact with a [FlutterMap].
 ///
-/// See https://docs.fleaflet.dev/usage/controller#initialisation for information
-/// on how to set-up and connect a controller to a map widget instance.
+/// Read the [online documentation](https://docs.fleaflet.dev/usage/programmatic-interaction)
+/// to get started.
 abstract class MapController {
-  /// Controller to programmatically interact with [FlutterMap], such as
-  /// controlling it and accessing some of its properties.
+  /// Controller to programmatically interact with a [FlutterMap].
   ///
-  /// See https://docs.fleaflet.dev/usage/controller#initialisation for
-  /// information how to set-up and connect a controller to a map widget
-  /// instance.
+  /// Read the [online documentation](https://docs.fleaflet.dev/usage/programmatic-interaction)
+  /// to get started.
   ///
   /// Factory constructor redirects to underlying implementation's constructor.
   factory MapController() = MapControllerImpl;