X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/c98a6f134f4b2b831e7e659de0c217c118270a61..e5f5d54a224254bb7227f0379d0af0dde81aff37:/docs/index.rst?ds=sidebyside diff --git a/docs/index.rst b/docs/index.rst index 0106c9c..7199b85 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,16 +1,13 @@ .. black documentation master file, created by sphinx-quickstart on Fri Mar 23 10:53:30 2018. -Black -===== +The uncompromising code formatter +================================= -**Black** is the uncompromising Python code formatter. - -By using *Black*, you -agree to cease control over minutiae of hand-formatting. In return, -*Black* gives you speed, determinism, and freedom from `pycodestyle` -nagging about formatting. You will save time and mental energy for -more important matters. +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 +and mental energy for more important matters. *Black* makes code review faster by producing the smallest diffs possible. Blackened code looks the same regardless of the project @@ -19,7 +16,7 @@ can focus on the content instead. .. note:: - Black is an early pre-release. + `Black is an early pre-release `_. Testimonials @@ -49,11 +46,15 @@ Contents .. toctree:: :maxdepth: 2 - usage - technical_philosophy - contributors_guide - changelog - + installation_and_usage + the_black_code_style + editor_integration + version_control_integration + ignoring_unmodified_files + contributing + change_log + reference/reference_summary + authors Indices and tables ==================