Document performance/trade-offs of generator functions

[feinstein]

The Flutter Style Guide discourages the use of generator functions, citing there's runtime overhead.

I wish this behaviour and trade-offs were documented somewhere.

Also, should the List/Iterable tutorials have a link to the generator docs?

[RedBrogdon]

Thanks for filing an issue, @feinstein. This does feel like something that would fit into the generators section in the function documentation:

https://dart.dev/language/functions#generators

Also, should the List/Iterable tutorials have a link to the generator docs?

Do you mind sharing a link for the tutorials you're referring to?

[feinstein]

Sure:

https://dart.dev/language/collections

https://dart.dev/libraries/async/using-streams