From 606ca7bf1350dc8b7b2bf56fc2aa55128629256d Mon Sep 17 00:00:00 2001
From: Paul Gauthier <aider@paulg.org>
Date: Thu, 29 Aug 2024 09:38:42 -0700
Subject: [PATCH] copy

---
 aider/website/docs/faq.md | 31 +++++++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/aider/website/docs/faq.md b/aider/website/docs/faq.md
index 06720ca43..89e05bf6e 100644
--- a/aider/website/docs/faq.md
+++ b/aider/website/docs/faq.md
@@ -59,23 +59,46 @@ to use for ignore patterns.
 You might have a few of these handy for when you want to work on
 frontend, backend, etc portions of your repo.
 
+## Can I use aider with multiple git repos at once?
+
+Currently aider can only work with one repo at a time.
+
+There are some things you can try if you need to work with
+multiple interrelated repos:
+
+- You can run aider in repo-A where you need to make a change
+and use `/read` to add some files read-only from another repo-B.
+This can let aider see key functions or docs from the other repo.
+- You can run `aider --show-repo-map > map.md` within each
+repo to create repo maps.
+You could then run aider in repo-A and 
+use `/read ../path/to/repo-B/map.md` to share
+a high level map of the other repo.
+- You can use aider to write documentation about a repo.
+Inside repo-B, you could run `aider docs.md`
+and work with aider to write some markdown docs.
+You can then `/read ../path/to/repo-B/docs.md` those docs in while using aider to
+edit repo-A.
+
+
 ## How can I run aider locally from source code?
 
 To run the project locally, follow these steps:
 
 ```
-# Clone the repository:
+# Clone the repository
 git clone git@github.com:paul-gauthier/aider.git
 
-# Navigate to the project directory:
+# Navigate to the project directory
 cd aider
 
 # It's recommended to make a virtual environment
 
-# Install the dependencies listed in the `requirements.txt` file:
+# Install aider in editable/development mode, 
+# so it runs from the latest copy of these source files
 python -m pip install -e .
 
-# Run the local version of Aider:
+# Run the local version of aider
 python -m aider
 ```