diff --git a/docs/settings.txt b/docs/settings.txt
index d93739e..8284a76 100644
--- a/docs/settings.txt
+++ b/docs/settings.txt
@@ -265,6 +265,13 @@ won't be necessary to change the default parser.
 The other two included parsers are considerably slower and should only be
 used if absolutely necessary.
 
+.. warning::
+
+    In some cases the ``compressor.parser.HtmlParser`` parser isn't able to
+    parse invalid HTML in JavaScript or CSS content. As a workaround you
+    should use one of the more forgiving parsers, e.g. the
+    ``BeautifulSoupParser``.
+
 The backends included in Django Compressor:
 
 - ``compressor.parser.AutoSelectParser``