diff --git a/spdy-core/src/main/java/org/eclipse/jetty/spdy/Promise.java b/spdy-core/src/main/java/org/eclipse/jetty/spdy/Promise.java
index 582ed54ba83..ef3eee17d1e 100644
--- a/spdy-core/src/main/java/org/eclipse/jetty/spdy/Promise.java
+++ b/spdy-core/src/main/java/org/eclipse/jetty/spdy/Promise.java
@@ -24,6 +24,12 @@ import java.util.concurrent.TimeoutException;
 
 import org.eclipse.jetty.spdy.api.Handler;
 
+/**
+ * <p>A {@link Promise} is a {@link Future} that allows a result or a failure to be set,
+ * so that the {@link Future} will be {@link #isDone() done}.</p>
+ *
+ * @param <T> the type of the result object
+ */
 public class Promise<T> implements Handler<T>, Future<T>
 {
     private final CountDownLatch latch = new CountDownLatch(1);