Skip to content

Scrapy, a fast high-level web crawling & scraping framework for Python.

Mark HTTP/2 as experimental

Adrián Chaves4d6359df2dfa
diff --git a/docs/topics/asyncio.rst b/docs/topics/asyncio.rst
index bfb430d52..c04044e8f 100644
--- a/docs/topics/asyncio.rst
+++ b/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:
diff --git a/docs/topics/commands.rst b/docs/topics/commands.rst
index 7de5e8121..eef6b36ff 100644
--- a/docs/topics/commands.rst
+++ b/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.
diff --git a/docs/topics/settings.rst b/docs/topics/settings.rst
index 8794e0259..218b23c87 100644
--- a/docs/topics/settings.rst
+++ b/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