diff --git a/docs/lang/python.md b/docs/lang/python.md
index e701751453..b13f67022f 100644
--- a/docs/lang/python.md
+++ b/docs/lang/python.md
@@ -53,6 +53,9 @@ pipenv
 You can specify a non-default location of this file by setting a `MISE_PYTHON_DEFAULT_PACKAGES_FILE`
 variable.
 
+## `.python-version` file support
+mise uses a mise.toml or .tool-versions file for auto-switching between software versions. However it can also read python-specific version files named `.python-version`.
+
 ## Precompiled python binaries
 
 By default, mise will