Some documentation on widgets/widget uses would be nice.

[TDuffinNTU]

A few examples would be:

• screenshots showing the appearance of widgets in their docstrings. Using flutter_goldens for this could work!
• mentioning dependencies for certain apps, such as AdwScaffold.actions requiring the `libadwaita_bitsdojo' package installed
• examples of usage for widgets (just a few lines would do just fine)

I'd be happy to have a go at some of this 👍

[prateekmedia]

If you can then go for it, waiting for your PR.