diff --git a/mopidy/frontends/http/__init__.py b/mopidy/frontends/http/__init__.py
index 9a4ee0e2..234f30b4 100644
--- a/mopidy/frontends/http/__init__.py
+++ b/mopidy/frontends/http/__init__.py
@@ -87,8 +87,13 @@ development. Details on it will appear here when it's released.
 
 **API stability**
 
-This frontend is currently to be regarded as **experimental**, and we are not
-promising to keep any form of backwards compatibility between releases.
+Since this frontend exposes our internal core API directly it is to be regarded
+as **experimental**. We cannot promise to keep any form of backwards
+compatibility between releases as we will need to change the core API while
+working out how to support new use cases. Thus, if you use this API, you must
+expect to do small adjustments to your client for every release of Mopidy.
+
+From Mopidy 1.0 and onwards, we intend to keep the core API far more stable.
 """
 
 # flake8: noqa