diff --git a/aider/website/docs/troubleshooting/imports.md b/aider/website/docs/troubleshooting/imports.md
index 2eba51b82..088e80916 100644
--- a/aider/website/docs/troubleshooting/imports.md
+++ b/aider/website/docs/troubleshooting/imports.md
@@ -10,22 +10,39 @@ all of its required dependencies.
 If aider reports `ImportErrors`, this probably means it has been installed
 incorrectly.
 
+## Install with pipx
 
-## Dependency versions
+If you are having problems with import errors you should consider
+[installing aider using pipx](/docs/install/pipx.html).
+This will ensure that aider is installed in its own python environment,
+with the correct set of dependencies.
 
-Aider pins its dependencies and is tested to work with those specific versions.
-You should be careful about upgrading or downgrading other python libraries that
-aider uses.
+## Package managers like Homebrew, AUR, ports
 
-If you need other versions of packages for your project,
-consider
+Package managers often install aider with the wrong dependencies, leading
+to import errors and other problems.
+It is not recommended to install aider with these tools.
+Instead, consider
 [installing aider using pipx](/docs/install/pipx.html).
 
+## Dependency versions matter
 
+Aider pins its dependencies and is tested to work with those specific versions.
+If you are installing aider with pip (rather than pipx),
+you should be careful about upgrading or downgrading the python packages that
+aider uses.
+
+In particular, be careful with the packages with pinned versions 
+noted at the end of
+[aider's requirements.in file](https://github.com/paul-gauthier/aider/blob/main/requirements/requirements.in).
+Also be wary of upgrading `litellm`, as it changes versions frequently
+and sometimes introduces bugs or backwards incompatible changes.
 
 ## Replit
 
-You can `pip install aider-chat` on replit, or you can install it via
-pipx.
+You can `pip install aider-chat` on replit.
+
+Or you can install aider with
+pipx as follows:
 
 {% include replit-pipx.md %}