[file_selector] Improve API docs and examples

[stuartmorgan]

The API docs for file_selector are extremely thin right now; they are pretty much just the one-sentence summary, with no explanation of parameters or edge cases (e.g., what a null return means). We also don't show examples of most of the parameters in the example app.

(/cc @ditman)

[TowaYamashita]

Hello. @ditman
I am interested in this issue because I have some experience using file_selector in my work.
So, I would like to work on this issue.
If at all possible, could you please assign this issue to me?
I'm not very good at English, so I'm worried if I'm expressing myself in a way that might offend you.
However, I will work diligently on the issue and I hope you will consider it.

[stuartmorgan]

You don't need to have the issue assigned to you to work on it; feel free to submit a PR with improvements.

[TowaYamashita]

@stuartmorgan
thanks, I will try it;

[ditman]

Thank you very much for your contribution @TowaYamashita! Looking forward to it!

[TowaYamashita]

Hi, @ditman
Could you please do code review?
I've added some comments about file_selector, but it would be nice if you could take a look at it to see if it's worded in a confusing way.

[ditman]

Thanks @TowaYamashita! I hadn't noticed your PR! @stuartmorgan has already assigned himself there, so he's probably going to review it soon! I'll take a quick look too!

Thanks for the contribution!

[TowaYamashita]

@ditman @stuartmorgan

Sorry for the delay in responding to your comment. 🙇
I planning on updating this PR .
I am currently modifying the code.

I do apologize for any inconvenience caused. 🙇

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar issue, please open a new bug, including the output of flutter doctor -v and a minimal reproduction of the issue.