copy

docs/faq.md

@@ -306,8 +306,10 @@ People regularly ask about how to add **many or all of their repo's files** to t
 This is probably not a good idea and will likely do more harm than good.
 
 The best approach is think about which files need to be changed to accomplish
-the task you are working on. Just add those files ot the chat.
+the task you are working on. Just add those files to the chat.
 
+Usually when people want to add "all the files" it's because they think it
+will give GPT helpful context about the overall code base.
 Aider will automatically give GPT a bunch of additional context about
 how those specific files relate to
 the rest of your git repo.
@@ -315,13 +317,10 @@ It does this by analyzing your entire codebase in light of the
 current chat to build a compact
 [repository map](https://aider.chat/2023/10/22/repomap.html).
 
-Usually when people want to add "all the files" it's because they think it
-will give GPT helpful context about the overall code base.
-The repo map usually does a good job at this without using a lot of tokens.
-
-Sending GPT a ton of code that is mostly irrelevant to the
-task at hand will often distract or confuse it.
-It will also increase the token costs on your OpenAI invoice.
+Adding a bunch of files that are mostly irrelevant to the
+task at hand will often distract or confuse GPT.
+GPT will give worse coding results, and sometimese even fail to correctly edit files.
+Addings extra files will also increase the token costs on your OpenAI invoice.
 
 Again, it's usually best to just add the files to the chat that will need to be modified.
 If you still wish to add lots of files to the chat, you can: