X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/0a340e1f227c3705ed1b0dbbbf634c98e2e82ada..8e0803e7e5acabdd28b80258f15d8aebf11fbb4c:/docs/index.rst?ds=sidebyside diff --git a/docs/index.rst b/docs/index.rst index df59f71..f03d247 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -4,7 +4,7 @@ The uncompromising code formatter ================================= -By using *Black*, you agree to cease control over minutiae of +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. @@ -14,9 +14,11 @@ possible. Blackened code looks the same regardless of the project you're reading. Formatting becomes transparent after a while and you can focus on the content instead. +Try it out now using the `Black Playground `_. + .. note:: - `Black is an early pre-release `_. + `Black is beta `_. Testimonials @@ -26,7 +28,7 @@ Testimonials *Black is opinionated so you don't have to be.* -**Hynek Schlawack**, creator of `attrs `_, core +**Hynek Schlawack**, creator of `attrs `_, core developer of Twisted and CPython: *An auto-formatter that doesn't suck is all I want for Xmas!* @@ -48,10 +50,16 @@ Contents installation_and_usage the_black_code_style + pyproject_toml + compatible_configs editor_integration + blackd + black_primer version_control_integration - ignoring_non_modified_files - contributing + github_actions + ignoring_unmodified_files + contributing_to_black + show_your_style change_log reference/reference_summary authors @@ -60,5 +68,4 @@ Indices and tables ================== * :ref:`genindex` -* :ref:`modindex` * :ref:`search`