1 files changed, 8 insertions, 0 deletions

diff --git a/README.md b/README.md
index 4e5ac00..32289da 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,14 @@ So tags are serialized according to these rules:
 - A tag that cannot have content: <foo> (no closing tag)
 - A tag that could have content, but doesn't: <foo></foo>
 
+## Known Issues
+
+Please check the issue queue for a full list, but the following are
+issues known issues that are not presently on the roadmap:
+
+- Rentrance: The current parser is not re-entrant. (Thus you can't pause
+  the parser to modify the HTML string mid-parse.)
+
 ## Thanks to...
 
 We owe a huge debt of gratitude to the original authors of html5lib.