explain each example

Author: dnadoba

Examples/README.md

@@ -9,3 +9,19 @@ swift run GetHTML
 ```
 To run other examples you can just replace `GetHTML` with the name of the example you want to run.
 
+## [GetHTML](./GetHTML/GetHTML.swift)
+
+This examples sends a HTTP GET request to `https://apple.com/` and first `await`s and `print`s the HTTP Response Head. 
+Afterwards it buffers the full response body in memory and prints the response as a `String`.    
+
+## [GetJSON](./GetJSON/GetJSON.swift)
+
+This examples sends a HTTP GET request to `https://xkcd.com/info.0.json` and first `await`s and `print`s the HTTP Response Head. 
+Afterwards it buffers the full response body in memory, decodes the buffer using a `JSONDecoder` and `dump`s the decoded response. 
+
+## [StreamByteCounter](./StreamByteCounter/StreamByteCounter.swift)
+
+This examples sends a HTTP GET request to `https://apple.com/` and first `await`s and `print`s the HTTP Response Head. 
+Afterwards it asynchronously iterates over all body fragments, counts the received bytes and prints a progress indicator (if the server send a content-length header).
+At the end the total received bytes are printed.
+Note that we drop all received fragment and therefore do **not** buffer the whole response body in-memory.

Examples/StreamingByteCounter/StreamingByteCounter.swift

@@ -39,7 +39,6 @@ struct StreamingByteCounter {
                     let progress = Double(receivedBytes) / Double(expectedBytes)
                     print("progress: \(Int(progress * 100))%")
                 }
-                // in case backpressure is needed, all reads will be paused until returned future is resolved
             }
             print("did receive \(receivedBytes) bytes")
         } catch {