slight adjustments to make docc rendering of AsyncBufferedByteIterator documentation nicer (apple#93)

* slight adjustments to make docc rendering of AsyncBufferedByteIterator documentation nicer

* Apply suggestions from code review

Co-authored-by: Chris Adamson <[email protected]>

Co-authored-by: Chris Adamson <[email protected]>

Author: phausler

Sources/AsyncAlgorithms/AsyncBufferedByteIterator.swift

@@ -9,8 +9,8 @@
 //
 //===----------------------------------------------------------------------===//
 
-/// AsyncBufferedByteIterator provides a convenient high-performance implementation
-/// of a common architecture for AsyncSequences of UInt8s (i.e. byte streams).
+/// An `AsyncIterator` that provides a convenient and high-performance implementation
+/// of a common architecture for `AsyncSequence` of `UInt8`, otherwise known as byte streams.
 ///
 /// Bytes are read into an internal buffer of `capacity` bytes via the
 /// `readFunction`. Invoking `next()` returns bytes from the internal buffer until it's