Improve documentation

[bartekpacia]

This issue tracks documentation-related efforts.

• remove stupid strings #196
• Docs, tutorials, cookbooks #81
• Add Getting started page to docs #205
• Add more docs for native features #284
• decide which term to use "Finder finds widget" vs "Finder resolves widget" and use it consistently #285
• add docs for global configuration using PatrolTesterConfig
• add some examples for thepatrol drive CLI command
  • say that files must end with _test.dart to be run by Patrol
• explain how RichText are different and how work with them
• add more documentation about how Patrol's custom finders are working
  • why .first, .last, .,at() may cause problems
• say about 2 ways of initializing NativeAutomator:
• Write tutorial about signing in with Facebook #286
• Write tutorial about signing in with Google #287
• Update documentation to use $.native #299
• Write tutorial on using Patrol in CI like GitHub Actions #333
• Write that we optimize for 90% of use cases and strive to stay consistent with Flutter, but improve for tester/developer experience where possible.
• Patrol's native automation is a novel feature in the Flutter world, and you might be curious about how we built it. We should document the architecture and internals (requested here)

[bartekpacia]

@jBorkowska, if you have some more suggestions, please share them :)

[lmlikota]

@bartekpacia I had to handle permission Do Not Disturb access using $.native.

This is my code and screenshot of the targeted permission

Screenshot of the targeted permission

Code to handle permission

await $.native.tap(Selector(text: '[QA] Haven First Responders'));
await $.native.tap(Selector(text: 'ALLOW'));
await $.native.pressBack();

It could be useful to others. Sorry for spamming this post, don't know where to post this, it's not discussion neither is issue 😄
Hm.. maybe to write a blog post about it?

[bartekpacia]

Thanks a lot for sharing this with us @lmlikota! :D

This sounds like a good candidate to add to the Tips & Tricks (this is the file for it) section in the docs. You can create a PR if you feel like it. If not, I'll do it in the near future.

[lmlikota]

I will create PR later in the evening. I'm glad I can help a bit 🙂

[bartekpacia]

We've made a lot of progress in terms of documentation, and I think it's a good time to close this issue :)

Please open new issues if you spot some bug or have a feature request regarding our docs.

[github-actions]

This issue has been automatically locked since there has not been any recent activity after it was closed. If you are still experiencing a similar problem, please file a new issue. Make sure to follow the template and provide all the information necessary to reproduce the issue.