diff --git a/docs/source/api.rst b/docs/source/api.rst
index 030b95e04..e8fa12394 100644
--- a/docs/source/api.rst
+++ b/docs/source/api.rst
@@ -2,6 +2,10 @@
 API
 ===
 
+.. warning:: The documentation here is currently being rewritten.  If something
+  doesn't make sense, the docs might be simply wrong. If so, please report it.
+
+
 .. autoclass:: spacy.en.English
 
   +-----------+----------------------------------------+-------------+--------------------------+