Allow setting custom cache directory on all platforms (#2739)

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

diff --git a/docs/index.rst b/docs/index.rst
index a7a7160f71ffa793b305e8ed89ef4a3bc25c9aea..6818c03cfe9b0c7ff213c1521c4c178db12b725f 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -4,6 +4,8 @@
 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
@@ -22,7 +24,7 @@ Try it out now using the `Black Playground <https://black.vercel.app>`_.
    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 versio
+   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.
@@ -39,6 +41,13 @@ Try it out now using the `Black Playground <https://black.vercel.app>`_.
 Testimonials
 ------------
 
+**Mike Bayer**, author of `SQLAlchemy <https://www.sqlalchemy.org/>`_:
+
+   *I can't think of any single tool in my entire programming career that has given me a
+   bigger productivity increase by its introduction. I can now do refactorings in about
+   1% of the keystrokes that it would have taken me previously when we had no way for
+   code to format itself.*
+
 **Dusty Phillips**, `writer <https://smile.amazon.com/s/ref=nb_sb_noss?url=search-alias%3Daps&field-keywords=dusty+phillips>`_:
 
    *Black is opinionated so you don't have to be.*
@@ -92,15 +101,18 @@ Contents
 .. toctree::
    :maxdepth: 3
    :includehidden:
+   :caption: User Guide
 
    getting_started
    usage_and_configuration/index
    integrations/index
    guides/index
+   faq
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
    :includehidden:
+   :caption: Development
 
    contributing/index
    change_log
@@ -108,10 +120,11 @@ Contents
 
 .. 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
 ==================