diff --git a/yesod-static/Yesod/Static.hs b/yesod-static/Yesod/Static.hs
index 3aa274a2..fdc0d683 100644
--- a/yesod-static/Yesod/Static.hs
+++ b/yesod-static/Yesod/Static.hs
@@ -118,6 +118,13 @@ staticDevel dir = do
 
 -- | Produce a 'Static' based on embedding all of the static
 -- files' contents in the executable at compile time.
+-- Nota Bene: if you replace the scaffolded 'static' call in Settings/StaticFiles.hs
+-- you will need to change the scaffolded addStaticContent.  Otherwise, some of your
+-- assets will be 404'ed.  This is because by default yesod will generate compile those
+-- assets to @static/tmp@ which for 'static' is fine since they are served out of the 
+-- directory itself.  With embedded static, that will not work.  
+-- You can easily change @addStaticContent@ to @\_ _ _ -> return Nothing@ as a workaround.
+-- This will cause yesod to embed those assets into the generated HTML file itself.  
 embed :: Prelude.FilePath -> Q Exp
 embed fp =
     [|Static (defaultWebAppSettings