Mark HTTP/2 as experimental

docs/topics/asyncio.rst

@@ -4,13 +4,14 @@ asyncio
 
 .. versionadded:: 2.0
 
-Scrapy has partial support :mod:`asyncio`. After you :ref:`install the asyncio
-reactor <install-asyncio>`, you may use :mod:`asyncio` and
+Scrapy has partial support for :mod:`asyncio`. After you :ref:`install the
+asyncio reactor <install-asyncio>`, you may use :mod:`asyncio` and
 :mod:`asyncio`-powered libraries in any :doc:`coroutine <coroutines>`.
 
-.. warning:: :mod:`asyncio` support in Scrapy is experimental. Future Scrapy
-             versions may introduce related changes without a deprecation
-             period or warning.
+.. warning:: :mod:`asyncio` support in Scrapy is experimental, and not yet
+             recommended for production environments. Future Scrapy versions
+             may introduce related changes without a deprecation period or
+             warning.
 
 .. _install-asyncio:
 

docs/topics/commands.rst

@@ -598,8 +598,6 @@ Example:
 Register commands via setup.py entry points
 -------------------------------------------
 
-.. note:: This is an experimental feature, use with caution.
-
 You can also add Scrapy commands from an external library by adding a
 ``scrapy.commands`` section in the entry points of the library ``setup.py``
 file.

docs/topics/settings.rst

@@ -678,6 +678,10 @@ The default HTTPS handler uses HTTP/1.1. To use HTTP/2 update
     Scrapy currently does not support HTTP/2 Cleartext (h2c) since none
     of the major browsers support HTTP/2 unencrypted (refer `http2 faq`_).
 
+.. warning:: HTTP/2 support in Scrapy is experimental, and not yet recommended
+             for production environments. Future Scrapy versions may introduce
+             related changes without a deprecation period or warning.
+
 .. _http2 faq: https://http2.github.io/faq/#does-http2-require-encryption
 
 .. setting:: DOWNLOAD_TIMEOUT