diff --git a/plugins/python-build/README.md b/plugins/python-build/README.md
index 1f074fb8..cff473c5 100644
--- a/plugins/python-build/README.md
+++ b/plugins/python-build/README.md
@@ -120,11 +120,17 @@ The exceptions -- non-default options that are set by default -- are listed belo
 
 ##### Homebrew
 
-Homebrew is used to find dependency packages if `brew` is found on `PATH`:
-* In MacOS, or
-* If the running Pyenv itself is installed with Homebrew
+In MacOS, Homebrew is used to find dependency packages if `brew` is found on `PATH`.
 
-Set `PYTHON_BUILD_USE_HOMEBREW` or `PYTHON_BUILD_SKIP_HOMEBREW` to override this default.
+Set `PYTHON_BUILD_SKIP_HOMEBREW` to avoid using it.
+
+---
+
+Homebrew is NOT used in Linux by default because it's rolling-release which causes a problem.
+Upgrading a Python dependency in Homebrew to a new major version (that `brew` does without warning)
+would break all Pyenv-managed installations that depend on it.
+You can use a community plugin [fix-version](https://github.com/pyenv/pyenv/wiki/Plugins#community-plugins)
+to fix installations in such a case.
 
 When Homebrew is used, its `include` and `lib` paths are added to compiler search path (the latter is also set as `rpath`),
 and also Python dependencies that are typically keg-only are searched for in the Homebrew installation and added individually.