Update README

Author: VanesaOshiro

packages/file_selector/file_selector/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 0.9.3
 
+* Improves API docs and examples.
 * Updates minimum Flutter version to 2.10.
 
 ## 0.9.2

packages/file_selector/file_selector/README.md

@@ -10,10 +10,11 @@ A Flutter plugin that manages files and interactions with file dialogs.
 |-------------|--------|-------|--------|-----|-------------|
 | **Support** | iOS 9+ | Any   | 10.11+ | Any | Windows 10+ |
 
-## Usage
+# Usage
+
 To use this plugin, add `file_selector` as a [dependency in your pubspec.yaml file](https://flutter.dev/platform-plugins/).
 
-### macOS
+## macOS
 
 You will need to [add an entitlement][entitlement] for either read-only access:
 ```xml
@@ -27,11 +28,23 @@ or read/write access:
 ```
 depending on your use case.
 
-### Examples
+# Feature supported platform
+Features support by platform:
+
+| Feature              | iOS      | Linux     | macOS     | Windows     | Android  |
+| -------------------- |--------- | --------- | --------- | ----------- | -------- |
+| Open a single file   | ✔️       | ✔️        | ✔️       | ✔️          | ❌      |
+| Open multiple files  | ✔️       | ✔️        | ✔️       | ✔️          | ❌      |
+| Saving a file        | ❌       | ✔️        | ✔️       | ✔️          | ❌      |
+| Get directory path   | ❌       | ✔️        | ✔️       | ✔️          | ❌      |
+
+# Example
+
 Here are small examples that show you how to use the API.
 Please also take a look at our [example][example] app.
 
-#### Open a single file
+## Open a single file
+
 <?code-excerpt "open_image_page.dart (SingleOpen)"?>
 ``` dart
 final XTypeGroup typeGroup = XTypeGroup(
@@ -42,7 +55,7 @@ final XFile? file =
     await openFile(acceptedTypeGroups: <XTypeGroup>[typeGroup]);
 ```
 
-#### Open multiple files at once
+## Open multiple files at once
 <?code-excerpt "open_multiple_images_page.dart (MultiOpen)"?>
 ``` dart
 final XTypeGroup jpgsTypeGroup = XTypeGroup(
@@ -59,7 +72,8 @@ final List<XFile> files = await openFiles(acceptedTypeGroups: <XTypeGroup>[
 ]);
 ```
 
-#### Saving a file
+## Saving a file
+
 <?code-excerpt "readme_standalone_excerpts.dart (Save)"?>
 ```dart
 const String fileName = 'suggested_name.txt';
@@ -76,6 +90,15 @@ final XFile textFile =
 await textFile.saveTo(path);
 ```
 
+## Get directory path
+
+<?code-excerpt "get_directory_page.dart (GetDirectory)"?>
+```dart
+const String confirmButtonText = 'Choose';
+final String? directoryPath = await getDirectoryPath(
+  confirmButtonText: confirmButtonText,
+);
+```
 ### Filtering by file types
 
 Different platforms support different type group filter options. To avoid
@@ -93,4 +116,4 @@ pass different `XTypeGroup`s based on `Platform`.
 † `mimeTypes` are not supported on version of macOS earlier than 11 (Big Sur).
 
 [example]:./example
-[entitlement]: https://docs.flutter.dev/desktop#entitlements-and-the-app-sandbox
+[entitlement]: https://docs.flutter.dev/desktop#entitlements-and-the-app-sandbox

packages/file_selector/file_selector/example/lib/get_directory_page.dart

@@ -14,10 +14,12 @@ class GetDirectoryPage extends StatelessWidget {
   final bool _isIOS = !kIsWeb && defaultTargetPlatform == TargetPlatform.iOS;
 
   Future<void> _getDirectoryPath(BuildContext context) async {
+    // #docregion GetDirectory
     const String confirmButtonText = 'Choose';
     final String? directoryPath = await getDirectoryPath(
       confirmButtonText: confirmButtonText,
     );
+    // #enddocregion GetDirectory
     if (directoryPath == null) {
       // Operation was canceled by the user.
       return;

packages/file_selector/file_selector/pubspec.yaml

@@ -3,7 +3,7 @@ description: Flutter plugin for opening and saving files, or selecting
   directories, using native file selection UI.
 repository: https://github.com/flutter/plugins/tree/main/packages/file_selector/file_selector
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
-version: 0.9.2
+version: 0.9.3
 
 environment:
   sdk: ">=2.12.0 <3.0.0"