Work on iluwatar#403, javadocs updated

npathai · npathai · commit ad11ea46b11e · 2016-08-29T11:55:30.000+05:30
diff --git a/promise/src/main/java/com/iluwatar/promise/Promise.java b/promise/src/main/java/com/iluwatar/promise/Promise.java
@@ -29,7 +29,11 @@
 import java.util.function.Function;
 
 /**
- * Implements the promise pattern.
+ * A Promise represents a proxy for a value not necessarily known when the promise is created. It
+ * allows you to associate dependent promises to an asynchronous action's eventual success value or
+ * failure reason. This lets asynchronous methods return values like synchronous methods: instead 
+ * of the final value, the asynchronous method returns a promise of having a value at some point 
+ * in the future.
  * 
  * @param <T> type of result.
  */
