From 5773d5cd2b532da185808f974a5875ca09064e28 Mon Sep 17 00:00:00 2001
From: cobalt <61329810+RedGuy12@users.noreply.github.com>
Date: Fri, 17 Nov 2023 15:39:44 -0600
Subject: [PATCH] Document target version inference (#4048)

---
 docs/usage_and_configuration/the_basics.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/usage_and_configuration/the_basics.md b/docs/usage_and_configuration/the_basics.md
index 6e7ee58..546fdc4 100644
--- a/docs/usage_and_configuration/the_basics.md
+++ b/docs/usage_and_configuration/the_basics.md
@@ -67,6 +67,10 @@ In a [configuration file](#configuration-via-a-file), you can write:
 target-version = ["py38", "py39", "py310", "py311"]
 ```
 
+By default, Black will infer target versions from the project metadata in
+`pyproject.toml`, specifically the `[project.requires-python]` field. If this does not
+yield conclusive results, Black will use per-file auto-detection.
+
 _Black_ uses this option to decide what grammar to use to parse your code. In addition,
 it may use it to decide what style to use. For example, support for a trailing comma
 after `*args` in a function call was added in Python 3.5, so _Black_ will add this comma