diff --git a/Yesod/Helpers/AtomFeed.hs b/Yesod/Helpers/AtomFeed.hs
index 57d2144e..ac559a4c 100644
--- a/Yesod/Helpers/AtomFeed.hs
+++ b/Yesod/Helpers/AtomFeed.hs
@@ -14,8 +14,7 @@
 --
 ---------------------------------------------------------
 
--- | Generation of Atom newsfeeds. See
--- <http://en.wikipedia.org/wiki/Atom_(standard)>.
+-- | Generation of Atom newsfeeds.
 module Yesod.Helpers.AtomFeed
     ( atomFeed
     , atomLink
diff --git a/Yesod/Helpers/Feed.hs b/Yesod/Helpers/Feed.hs
index 581b5a04..9057529c 100644
--- a/Yesod/Helpers/Feed.hs
+++ b/Yesod/Helpers/Feed.hs
@@ -8,9 +8,12 @@
 -- Stability     : Stable
 -- Portability   : Portable
 --
--- Generic Feed and Feed Entry data types that can be used as either and
+-- Generic Feed and Feed Entry data types that can be used as either an
 -- Rss feed or an Atom feed (or both, or other).
 --
+-- Atom spec: <http://en.wikipedia.org/wiki/Atom_(standard)>
+-- Rss spec:  <http://www.rssboard.org/rss-specification#sampleFiles>
+--
 -------------------------------------------------------------------------------
 module Yesod.Helpers.Feed
     ( Feed(..)
@@ -25,8 +28,15 @@ data Feed url = Feed
     { feedTitle       :: String
     , feedLinkSelf    :: url
     , feedLinkHome    :: url
+
+
+    -- | note: currently only used for Rss
     , feedDescription :: Html
+
+    -- | note: currently only used for Rss, possible values: 
+    --   <http://www.rssboard.org/rss-language-codes>
     , feedLanguage    :: String
+
     , feedUpdated     :: UTCTime
     , feedEntries     :: [FeedEntry url]
     }