diff --git a/core/src/main/java/hudson/FeedAdapter.java b/core/src/main/java/hudson/FeedAdapter.java
index 49baf94320..3772fe0b58 100644
--- a/core/src/main/java/hudson/FeedAdapter.java
+++ b/core/src/main/java/hudson/FeedAdapter.java
@@ -8,8 +8,26 @@ import java.util.Calendar;
  * @author Kohsuke Kawaguchi
  */
 public interface FeedAdapter<E> {
+    /**
+     * Gets the human readable title of the entry.
+     * In RSS readers, this is usually displayed like an e-mail subject.
+     */
     String getEntryTitle(E entry);
+
+    /**
+     * Gets the URL that represents this entry.
+     * Relative to context root of the Hudson.
+     */
     String getEntryUrl(E entry);
+
+    /**
+     * Unique ID of each entry.
+     * RSS readers use this to determine what feeds are new and what are not.
+     */
     String getEntryID(E entry);
+
+    /**
+     * Timestamp of the last change in ithis entry.
+     */
     Calendar getEntryTimestamp(E entry);
 }