# HG changeset patch
# User chegar
# Date 1516135242 0
# Node ID fc030486080eee6cd8f01da84122e6beb1ab6ffa
# Parent  bc8bc0b99add2c9390014c804ca83d9f47dec68d
http-client-tutorial: comments

diff -r bc8bc0b99add -r fc030486080e src/main/java/openjdk/http/tutorial/exercise1/Retrievals.java
--- a/src/main/java/openjdk/http/tutorial/exercise1/Retrievals.java	Tue Jan 16 20:12:22 2018 +0000
+++ b/src/main/java/openjdk/http/tutorial/exercise1/Retrievals.java	Tue Jan 16 20:40:42 2018 +0000
@@ -48,6 +48,20 @@
 import static jdk.incubator.http.HttpResponse.BodyHandler.*;
 
 /**
+ * The JDK HTTP Client tutorial.
+ *
+ * Consists of a set of exercises that must be completed. Each exercise is
+ * represented as a method, whose method body must be written successfully to
+ * complete the exercise. Each method-level comment describes the particular
+ * exercise, what must be done, and may provide a hint to help complete it.
+ *
+ * The test source tree contains `Exercise1Test` that contains a set of unit
+ * tests, similarly named to the to the methods in this class, that, when
+ * executed, verify that the exercises have been completed successfully ( by
+ * checking the value returned by each exercise ). These can be run through the
+ * Maven Project's `test` target.
+ *
+ *
  * @author Chris Hegarty
  */
 public class Retrievals {