Elaborate on Python support policy (#2819)

[etc/vim.git] / docs / index.rst

diff --git a/docs/index.rst b/docs/index.rst
index 44b800cadf8d95492c11665eed1de764c231471d..8a8da0d6127e45137082cd8eb118571e1e8c9cc2 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -4,6 +4,8 @@
 The uncompromising code formatter
 =================================
 
 The uncompromising code formatter
 =================================
 

+    “Any color you like.”
+

 By using *Black*, you agree to cede control over minutiae of
 hand-formatting. In return, *Black* gives you speed, determinism, and
 freedom from `pycodestyle` nagging about formatting. You will save time
 By using *Black*, you agree to cede control over minutiae of
 hand-formatting. In return, *Black* gives you speed, determinism, and
 freedom from `pycodestyle` nagging about formatting. You will save time


@@ -16,16 +18,14 @@ can focus on the content instead.
 
 Try it out now using the `Black Playground <https://black.vercel.app>`_.
 
 
 Try it out now using the `Black Playground <https://black.vercel.app>`_.
 

-.. admonition:: Note - this is a beta product
+.. admonition:: Note - Black is now stable!

 
 

-   *Black* is already `successfully used <https://github.com/psf/black#used-by>`_ by
+   *Black* is `successfully used <https://github.com/psf/black#used-by>`_ by

    many projects, small and big. *Black* has a comprehensive test suite, with efficient
    many projects, small and big. *Black* has a comprehensive test suite, with efficient

-   parallel tests, our own auto  formatting and parallel Continuous Integration runner.
-   However, *Black* is still beta. Things will probably be wonky for a while. This is
-   made explicit by the "Beta" trove classifier, as well as by the "b" in the version
-   number. What this means for you is that **until the formatter becomes stable, you
-   should expect some formatting to change in the future**. That being said, no drastic
-   stylistic changes are planned, mostly responses to bug reports.
+   parallel tests, our own auto formatting and parallel Continuous Integration runner.
+   Now that we have become stable, you should not expect large formatting to changes in
+   the future. Stylistic changes will mostly be responses to bug reports and support for new Python
+   syntax.

 
    Also, as a safety measure which slows down processing, *Black* will check that the
    reformatted code still produces a valid AST that is effectively equivalent to the
 
    Also, as a safety measure which slows down processing, *Black* will check that the
    reformatted code still produces a valid AST that is effectively equivalent to the


@@ -99,6 +99,7 @@ Contents
 .. toctree::
    :maxdepth: 3
    :includehidden:
 .. toctree::
    :maxdepth: 3
    :includehidden:

+   :caption: User Guide

 
    getting_started
    usage_and_configuration/index
 
    getting_started
    usage_and_configuration/index


@@ -107,8 +108,9 @@ Contents
    faq
 
 .. toctree::
    faq
 
 .. toctree::

-   :maxdepth: 3
+   :maxdepth: 2

    :includehidden:
    :includehidden:

+   :caption: Development

 
    contributing/index
    change_log
 
    contributing/index
    change_log


@@ -116,10 +118,11 @@ Contents
 
 .. toctree::
    :hidden:
 
 .. toctree::
    :hidden:

+   :caption: Project Links

 
 

-   GitHub ↪ <https://github.com/psf/black>
-   PyPI ↪ <https://pypi.org/project/black>
-   IRC ↪ <https://webchat.freenode.net/?channels=%23blackformatter>
+   GitHub <https://github.com/psf/black>
+   PyPI <https://pypi.org/project/black>
+   Chat <https://discord.gg/RtVdv86PrH>

 
 Indices and tables
 ==================
 
 Indices and tables
 ==================