diff --git a/README.md b/README.md
index d2cc60727..ac2de7029 100644
--- a/README.md
+++ b/README.md
@@ -1,11 +1,9 @@
 # aider is GPT-4 powered coding in your terminal
 
 `aider` is a command-line chat tool that allows you to write and edit
-code with GPT-4 in the terminal.  You can ask GPT to help you start
+code with GPT-4.  You can ask GPT to help you start
 a new project, or add features to your existing code.
-`aider` is especially useful for working with code in a git repo, as
-it will automatically commit GPT's code changes with a descriptive
-commit message.
+`aider` is especially suited for working with code in a git repo, as it has features for committing, diffing and undoing changes proposed by GPT. 
 
 ![aider screenshot](screenshot.gif)
 
diff --git a/docs/ctags.md b/docs/ctags.md
index 8c3a3beba..dab26cb26 100644
--- a/docs/ctags.md
+++ b/docs/ctags.md
@@ -69,8 +69,10 @@ But it's not ideal to have to manually identify the right
 set of files to add to the chat.
 And sending whole files is a bulky way to send code context,
 wasting the precious 8k context window.
-You may quickly run out of context window if you need to
-send many files worth of context.
+GPT doesn't need to see the entire implementation of BarLog,
+it just needs to understand it well enough to use it. 
+You may quickly run out of context window if you
+send many files worth of code just to convey context.
 
 ## Using a repo map to provide context