From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Sat, 24 Jul 2021 22:59:53 +0000 (-0700)
Subject: Clarify contributing docs (#2398)
X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/6665677495974cb56e12d717d4e796bbc211dc6a?ds=sidebyside;hp=6559bdbd9dcf71ba0017d66bb133c744bd83b0e3

Clarify contributing docs (#2398)

"as configurable as gofmt" means little to people who haven't used gofmt.
---

diff --git a/docs/contributing/index.rst b/docs/contributing/index.rst
index 7e3a909..480dbd6 100644
--- a/docs/contributing/index.rst
+++ b/docs/contributing/index.rst
@@ -15,8 +15,9 @@ Welcome! Happy to see you willing to make the project better. Have you read the
 
 .. rubric:: Bird's eye view
 
-In terms of inspiration, *Black* is about as configurable as *gofmt*. This is
-deliberate.
+In terms of inspiration, *Black* is about as configurable as *gofmt* (which is to say,
+not very). This is deliberate. *Black* aims to provide a consistent style and take away
+opportunities for arguing about style.
 
 Bug reports and fixes are always welcome! Please follow the
 `issue template on GitHub <https://github.com/psf/black/issues/new>`_ for best results.