☂️ Improve Widget and Driver Tests sections

[kentcb]

Per this discussion, it seems widget tests are under-documented in these ways:

• unclear why UI appears small with black regions above and below it
• unclear whether that behavior can be overridden or modified in any way
• it was unclear to me that driver and widget tests were a different thing, and how they differ. That said, this documentation seems pretty good. Perhaps I missed that when I was trying this stuff out.

Ultimately, what I want to do is use automate the execution of widget tests on my CI to take snapshots of the app at various points. This way, I can set up a feed for my test team to monitor to see if anything visual breaks during the development of an application. Of course, I will need to choose a resolution at which to take the snapshots, but I am unclear on how I can achieve this.

---

This should include:

• [ ] https://github.com/flutter/website/issues/2005
• [ ] https://github.com/flutter/website/issues/3609
• [ ] https://github.com/flutter/website/issues/4855
• [ ] https://github.com/flutter/website/issues/8022

[eseidelGoogle]

This is a @yjbanov or @Hixie question. Thanks!

[Hixie]

Where did you look for this information? (Not sure where to put the answers.)

[kentcb]

I think I started here, but I'd swear those docs have been improved recently, because they certainly looked more fleshed out than I recall. However, the commit history says otherwise, so I guess I just didn't take it all in the first time. Regardless, I still think clarity is required around widget tests/black area.

[Hixie]

We can definitely improve them!

[zoechi]

Related flutter/flutter#12994, flutter/flutter#19181, flutter/flutter#5885, flutter/flutter#5026 https://github.com/flutter/flutter/wiki/Writing-a-golden-file-test-for-package%3Aflutter