api [nfc]: Tighten comments about streaming JSON-plus-UTF-8 decoder

This is a bit off the main line of what a reader of this method will
mostly want to know about (as the method is mainly about semantics,
not performance optimization).  So keep the comments fairly short,
to avoid distracting the reader's focus from the rest of the method.

Author: gnprice

lib/api/core.dart

@@ -147,13 +147,9 @@ class ApiConnection {
     final int httpStatus = response.statusCode;
     Map<String, dynamic>? json;
     try {
-      // Pass the response stream through the `jsonUtf8Decoder` transformer,
-      // allowing decoding to start as soon as the response stream emits data
-      // chunks.
+      // The stream-oriented `bind` method allows decoding to happen in chunks
+      // while the response is still being downloaded, improving latency.
       final jsonStream = jsonUtf8Decoder.bind(response.stream);
-
-      // Actually start listening to the response byte stream and wait for
-      // decoding to finish.
       json = await jsonStream.single as Map<String, dynamic>?;
     } catch (e) {
       // We'll throw something below, seeing `json` is null.