copy

HISTORY.md

@@ -14,7 +14,7 @@
   - Bugfix to properly handle subprocess encodings (also for `/run`).
 - Improved [docker support](https://aider.chat/docs/install/docker.html):
   - Resolved permission issues when using `docker run --user xxx`.
-  - New paulgauthier/aider-full docker image, which includes all extras.
+  - New `paulgauthier/aider-full` docker image, which includes all extras.
 - Switching to code and ask mode no longer summarizes the chat history.
 - Added graph of aider's contribution to each release.
 - Generic auto-completions are provided for `/commands` without a completion override.

aider/website/docs/install/docker.md

@@ -5,13 +5,34 @@ nav_order: 100
 
 # Aider with docker
 
-You can run aider via docker without doing any local installation, like this:
+Aider is available as 2 docker images:
+
+- `paulgauthier/aider` installs the aider core, a smaller image that's good to get started quickly.
+- `paulgauthier/aider-full` installs aider will all the optional extras.
+
+The full image has support for features like interactive help, the
+browser GUI and support for using Playwright to scrape web pages.  The
+core image can still use these features, but they will need to be
+installed the first time you access them. Since containers are
+ephemeral, they extras will need to be reinstalled the next time you
+launch the aider core container.
+
+### Aider core 
 
 ```
 docker pull paulgauthier/aider
 docker run -it --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]
 ```
 
+### Full version
+
+```
+docker pull paulgauthier/aider-full
+docker run -it --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]
+```
+
+## How to use it
+
 You should run the above commands from the root of your git repo,
 since the `--volume` arg maps your current directory into the
 docker container.
@@ -29,19 +50,6 @@ git config user.email "you@example.com"
 git config user.name "Your Name"
 ```
 
-## Full version
-
-The above command installs the aider core, which is missing some of the extra
-features like interactive help, the browser GUI and Playwright support for
-scraping web pages.
-
-Use `paulgauthier/aider-full` to get all the features, at the expense of a larger
-docker image.
-
-```
-docker pull paulgauthier/aider-full
-docker run -it --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]
-```
 
 ## Limitations