diff --git a/components/promise.rst b/components/promise.rst
index 0ec5da3..e33c821 100644
--- a/components/promise.rst
+++ b/components/promise.rst
@@ -4,3 +4,10 @@ Promise
 Promise used for asynchronous HTTP requests.
 
 This will eventually be removed/deprecated and replaced with the upcoming Promise PSR.
+
+.. note::
+
+    Contract for the ``Http\Promise\Promise`` is temporary until `PSR is released`_.
+    Once it is out, we will use this PSR in the main client and deprecate the old contract.
+
+.. _`PSR is released`: https://groups.google.com/forum/?fromgroups#!topic/php-fig/wzQWpLvNSjs
diff --git a/httplug.rst b/httplug.rst
index 10f2b7a..eb59051 100644
--- a/httplug.rst
+++ b/httplug.rst
@@ -17,12 +17,7 @@ There is also the ``Http\Client\HttpAsyncClient`` which provides the
 The promise allows to specify handlers for a PSR-7 ``ResponseInterface``
 or an exception that implements ``Http\Client\Exception``.
 
-.. warning::
-
-    Contract for the ``Http\Promise\Promise`` is temporary until `PSR is released`_.
-    Once it is out, we will use this PSR in the main client and deprecate the old contract.
-
-See the :doc:``tutorial`` for a concrete example.
+See the :doc:`tutorial </httplug/tutorial>` for a concrete example.
 
 
 .. toctree::
@@ -32,4 +27,3 @@ See the :doc:``tutorial`` for a concrete example.
    Migrating <httplug/migrating>
    Virtual Package <httplug/virtual-package>
 
-.. _`PSR is released`: https://groups.google.com/forum/?fromgroups#!topic/php-fig/wzQWpLvNSjs