diff --git a/pages/common/black.md b/pages/common/black.md
index 07c503b277..e9608b65e8 100644
--- a/pages/common/black.md
+++ b/pages/common/black.md
@@ -1,7 +1,7 @@
 # black
 
 > A Python auto code formatter.
-> More information: <https://github.com/psf/black>.
+> More information: <https://black.readthedocs.io/en/stable/usage_and_configuration/the_basics.html>.
 
 - Auto-format a file or entire directory:
 
@@ -11,15 +11,15 @@
 
 `black -c "{{code}}"`
 
-- Output the changes that would be applied for each file:
-
-`black --diff {{path/to/file_or_directory}}`
-
-- Perform a dry run (print what would be done without actually doing it):
+- Output whether a file or a directory would have changes made to them if they were to be formatted:
 
 `black --check {{path/to/file_or_directory}}`
 
-- Auto-format a file or directory emitting exclusively error messages to stderr:
+- Output changes that would be made to a file or a directory without performing them (dry-run):
+
+`black --diff {{path/to/file_or_directory}}`
+
+- Auto-format a file or directory, emitting exclusively error messages to stderr:
 
 `black --quiet {{path/to/file_or_directory}}`