diff --git a/.mkdocs.yml b/.mkdocs.yml
index 0d297a1..f1e1766 100644
--- a/.mkdocs.yml
+++ b/.mkdocs.yml
@@ -33,4 +33,5 @@ nav:
     - sec-levels.md
     - tests.md
     - relnotes.md
+    - knownissues.md
 
diff --git a/docs/knownissues.md b/docs/knownissues.md
new file mode 100644
index 0000000..9645ea4
--- /dev/null
+++ b/docs/knownissues.md
@@ -0,0 +1,11 @@
+
+# Known issues
+
+This file contains a list of the most common known issues, and the release
+range affected. It can be useful for people running older versions, to
+identify problems (and workarounds) faster.
+
+Entries are eventually be purged once their affected versions become uncommon,
+to prevent confusion.
+
+