diff --git a/README.md b/README.md
index f209d15..93095fd 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,9 @@ Requirements:
 - Ruby
 - bundler
 - Installs nokogiri
+
+# Known Issues
+
+- Inline references are not handled in the best possible way
+- metadata.xml is not complete. There are just too many authors
+- Foreword/Preface is not part of the index