fix: Improve federated plugin documentation and melos CI setup

Documentation improvements:
- Simplify platform package READMEs to avoid duplication and maintenance burden
- Remove detailed setup/limitations from platform packages, keeping only basic usage
- All comprehensive documentation remains in the main workmanager package
- Follow industry best practices from permission_handler and url_launcher

CI improvements:
- Add Flutter/Dart version verification step in analysis workflow
- Use melos bootstrap --sdk-path auto to ensure proper SDK detection
- Fix mixed Dart/Flutter package resolution issues in CI environment

This follows federated plugin best practices where platform packages
have minimal READMEs directing users to the main package documentation.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ened

.github/workflows/analysis.yml

@@ -13,10 +13,14 @@ jobs:
         with:
           channel: "stable"
           cache: true
+      - name: Verify Flutter and Dart are available
+        run: |
+          flutter --version
+          dart --version
       - name: bootstrap
         run: |
           dart pub global activate melos
-          melos bootstrap
+          melos bootstrap --sdk-path auto
       - uses: axel-op/dart-package-analyzer@v3
         with:
           githubToken: ${{ secrets.GITHUB_TOKEN }}

workmanager_android/README.md

@@ -18,36 +18,10 @@ dependencies:
   workmanager_android: ^0.8.0
 ```
 
-## Android setup
+## Documentation
 
-Add the following to your `android/app/src/main/AndroidManifest.xml`:
-
-```xml
-<!-- Background processing permissions -->
-<uses-permission android:name="android.permission.WAKE_LOCK" />
-<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
-```
-
-For more detailed setup instructions, see the [Android setup documentation][android_setup].
-
-## Features
-
-This Android implementation supports:
-
-- **One-off tasks**: Execute background tasks once after a delay
-- **Periodic tasks**: Execute background tasks repeatedly at specified intervals
-- **Task constraints**: Network, charging, battery, storage, and device idle requirements
-- **Task cancellation**: Cancel individual tasks or all tasks
-- **Work policies**: Configure what happens when tasks with the same unique name are registered
-- **Backoff policies**: Configure retry behavior for failed tasks
-- **Task scheduling info**: Check if periodic tasks are currently scheduled
-
-## Limitations
-
-- Processing tasks are not supported on Android (use one-off tasks instead)
-- Tag-based operations work with individual tasks
-- iOS-specific features like `printScheduledTasks` are not available
+For detailed setup instructions, usage examples, and platform-specific information, 
+please refer to the main [`workmanager`][workmanager] package documentation.
 
 [workmanager]: https://pub.dartlang.org/packages/workmanager
-[federated_plugin_docs]: https://flutter.dev/go/federated-plugins
-[android_setup]: https://github.com/fluttercommunity/flutter_workmanager/blob/main/ANDROID_SETUP.md
+[federated_plugin_docs]: https://flutter.dev/go/federated-plugins

workmanager_ios/README.md

@@ -18,42 +18,10 @@ dependencies:
   workmanager_ios: ^0.8.0
 ```
 
-## iOS setup
+## Documentation
 
-For iOS background processing, you need to configure your app properly. 
-For detailed setup instructions, see the [iOS setup documentation][ios_setup].
-
-## Features
-
-This iOS implementation supports:
-
-- **One-off tasks**: Execute background tasks once using BGTaskScheduler (iOS 13+)
-- **Periodic tasks**: Execute background tasks using BGAppRefreshTask (iOS 13+) or Background Fetch
-- **Processing tasks**: Execute long-running background tasks using BGProcessingTask (iOS 13+)
-- **Task cancellation**: Cancel individual tasks or all tasks
-- **Task constraints**: Network and charging requirements (iOS 13+)
-- **Task scheduling info**: Print information about scheduled tasks (iOS 13+)
-
-## Limitations
-
-- **iOS 13+ required**: BGTaskScheduler features require iOS 13 or later
-- **Tags not supported**: `cancelByTag` operations are not available on iOS
-- **No scheduling status**: `isScheduledByUniqueName` is not supported on iOS
-- **Background execution limits**: iOS strictly limits background execution time and frequency
-- **System scheduling**: iOS determines when tasks actually run based on user behavior and system resources
-
-## Background execution on iOS
-
-Please note that iOS has strict limitations on background execution:
-
-- Background tasks are scheduled by the system and may not run immediately
-- The system considers user behavior patterns when scheduling background work
-- Tasks may be throttled or denied if the app is used infrequently
-- Background App Refresh must be enabled by the user for your app
-
-For more information, see Apple's [Background Tasks documentation][apple_background_tasks].
+For detailed setup instructions, usage examples, and platform-specific information, 
+please refer to the main [`workmanager`][workmanager] package documentation.
 
 [workmanager]: https://pub.dartlang.org/packages/workmanager
-[federated_plugin_docs]: https://flutter.dev/go/federated-plugins
-[ios_setup]: https://github.com/fluttercommunity/flutter_workmanager/blob/main/IOS_SETUP.md
-[apple_background_tasks]: https://developer.apple.com/documentation/backgroundtasks
+[federated_plugin_docs]: https://flutter.dev/go/federated-plugins