examples_of_good_comments.txt

private async IAsyncEnumerable<MemoryStream> YieldStreams(params byte[][] bs)
{
    // The compiler turns async + yield return type T into the
    // desired return type of IAsyncEnumerable<T>. But we don't
    // actually have any async code, just need the type. Soooo
    await Task.CompletedTask; // hack to evade compiler warning

    foreach (var b in bs) yield return new MemoryStream(b);
}