Load .env from home, git, cwd, cmd line arg

aider/website/docs/config/aider_conf.md

@@ -12,12 +12,12 @@ your git repo.
 
 {% include special-keys.md %}
 
-Below is a sample of the file, which you
+{% include env-keys-tip.md %}
+
+Below is a sample of the YAML config file, which you
 can also
 [download from GitHub](https://github.com/paul-gauthier/aider/blob/main/aider/website/assets/sample.aider.conf.yml).
 
-{% include env-keys-tip.md %}
-
 <!--[[[cog
 from aider.args import get_sample_yaml
 from pathlib import Path

aider/website/docs/config/dotenv.md

@@ -13,9 +13,14 @@ in the `.env` file.
 
 {% include special-keys.md %}
 
-Aider will look for a `.env` file in the
-root of your git repo or in the current directory.
-You can give it an explicit file to load with the `--env-file <filename>` parameter.
+Aider will look for a `.env` file in these locations:
+
+- Your home directory.
+- The root of your git repo.
+- The current directory.
+- As specified with the `--env-file <filename>` parameter.
+
+If the files above exist, they will be loaded in that order. Files loaded last will take priority.
 
 Below is a sample `.env` file, which you
 can also

aider/website/docs/install/optional.md

@@ -14,7 +14,7 @@ The steps below are completely optional.
 
 ## Store your api keys 
 
-You can place your [api keys in a `.env` file](/docs/config/dotenv.html)
+You can [store your api keys in a .env file](/docs/config/dotenv.html)
 and they will be loaded automatically whenever you run aider.
 
 ## Enable Playwright