dart-lang / site-www

Source for Dart website
https://dart.dev
Other
970 stars 702 forks source link

`yield*` is not well documented #2469

Open jamesderlin opened 4 years ago

jamesderlin commented 4 years ago

https://github.com/dart-lang/site-www/pull/510 added yield* to the language tour, but it just says:

If your generator is recursive, you can improve its performance by using yield*:

which is a bit vague and doesn't explain what yield* actually does.

The old Dart Language Asynchrony Support: Phase 2 article had a more thorough explanation, and I can't find any counterpart on the current Dart site.

atsansone commented 1 year ago

@MaryaBelanger : Can you add this to the language work you're reviewing?