Document AsyncMarker.SyncYielding and native yields.
Document AsyncMarker.SyncYielding and native yields.

BUG=
R=asgerf@google.com, kustermann@google.com

Review URL: https://chromereviews.googleplex.com/481977013 .

dart-archive/kernel,dart-lang/kernel