Improve documentation for `Future.wait`.

Improve documentation for `Future.wait`.

Fixes #29337
BUG= http://dartbug.com/29337
R=lrn@google.com

Committed: https://github.com/dart-lang/sdk/commit/6772402aa76fdf6e304a639f2f523e7797684920

[floitsch, 2017-04-18 08:58:15]

floitsch@google.com changed reviewers:
+ lrn@google.com

[floitsch, 2017-04-25 17:34:06]

ping.

[Lasse Reichstein Nielsen, 2017-04-26 08:28:46]

lgtm

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.dart
File sdk/lib/async/future.dart (right):

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.da...
sdk/lib/async/future.dart:293: * complete.
Maybe: are complete -> have completed
(I think we generally uses "complete" as an action of a Future, not a state)

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.da...
sdk/lib/async/future.dart:299: * completes with the first seen error instead.
first seen error -> first error seen
(I think)

[floitsch, 2017-04-26 15:33:49]

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.dart
File sdk/lib/async/future.dart (right):

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.da...
sdk/lib/async/future.dart:293: * complete.
On 2017/04/26 08:28:46, Lasse Reichstein Nielsen wrote:
> Maybe: are complete -> have completed
> (I think we generally uses "complete" as an action of a Future, not a state)

Done.

https://codereview.chromium.org/2824143002/diff/20001/sdk/lib/async/future.da...
sdk/lib/async/future.dart:299: * completes with the first seen error instead.
On 2017/04/26 08:28:46, Lasse Reichstein Nielsen wrote:
> first seen error -> first error seen
> (I think)

Reworded with the help of Seth.

[floitsch, 2017-04-26 15:34:27]

Description was changed from

==========
Improve documentation for `Future.wait`.

Fixes #29337
BUG= http://dartbug.com/29337
==========

to

==========
Improve documentation for `Future.wait`.

Fixes #29337
BUG= http://dartbug.com/29337
R=lrn@google.com

Committed:
https://github.com/dart-lang/sdk/commit/6772402aa76fdf6e304a639f2f523e7797684920
==========

[floitsch, 2017-04-26 15:34:29]

Committed patchset #3 (id:40001) manually as
6772402aa76fdf6e304a639f2f523e7797684920 (presubmit successful).