diff --git a/core/src/main/java/hudson/FeedAdapter.java b/core/src/main/java/hudson/FeedAdapter.java
index 340c7c3421..8971aab770 100644
--- a/core/src/main/java/hudson/FeedAdapter.java
+++ b/core/src/main/java/hudson/FeedAdapter.java
@@ -5,6 +5,11 @@ import java.util.Calendar;
 /**
  * Provides a RSS feed view of the data.
  *
+ * <p>
+ * This interface allows data structure of any form to be exposed
+ * as RSS feeds, just by writing a stateless singleton adapter code that
+ * implements this interface.
+ *
  * @author Kohsuke Kawaguchi
  */
 public interface FeedAdapter<E> {