From 3a70ea9fafefc2f41f85088ec1c2068092966b24 Mon Sep 17 00:00:00 2001
From: Paul Gauthier <aider@paulg.org>
Date: Wed, 31 Jul 2024 10:45:25 -0300
Subject: [PATCH] copy

---
 HISTORY.md                           |  2 +-
 aider/website/docs/install/docker.md | 36 +++++++++++++++++-----------
 2 files changed, 23 insertions(+), 15 deletions(-)

diff --git a/HISTORY.md b/HISTORY.md
index 4817fb10b..37be826e6 100644
--- a/HISTORY.md
+++ b/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.
diff --git a/aider/website/docs/install/docker.md b/aider/website/docs/install/docker.md
index 7e1944b3b..630b0f829 100644
--- a/aider/website/docs/install/docker.md
+++ b/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