diff --git a/README.md b/README.md
index 394de3306..41450fd74 100644
--- a/README.md
+++ b/README.md
@@ -9,25 +9,23 @@ commit, diff and undo changes proposed by GPT.
 
 ![aider screenshot](assets/screenshot.gif)
 
-## Example chat transcripts
-
-Here are some example transcripts that show how you can chat with `aider` to write and edit code with GPT-4. 
-
-## Table of Contents
+## Table of contents
 
 - [Example chat transcripts](#example-chat-transcripts)
 - [Features](#features)
 - [Installation](#installation)
 - [Usage](#usage)
-- [Chat commands](#chat-commands)
+- [In chat commands](#in-chat-commands)
 - [Tips](#tips)
 - [Limitations](#limitations)
 
 ## Example chat transcripts
 
+Here are some example transcripts that show how you can chat with `aider` to write and edit code with GPT-4. 
+
 * [**Hello World Flask App**](https://aider.chat/examples/hello-world-flask.html): Start from scratch and have GPT create a simple Flask app with various endpoints, such as adding two numbers and calculating the Fibonacci sequence.
 
-* [**Javascript Game Modification**](https://aider.chat/examples/2048-game.html): Dive
+* [**Javascript Game Modification**](https://aider.chat/examples/2048-game.html): Dive into an existing open-source repo, and get GPT's help to understand it and make modifications.
 
 * [**Complex Multi-file Change with Debugging**](https://aider.chat/examples/complex-change.html): GPT makes a complex code change that is coordinated across multiple source files, and resolves bugs by reviewing error output and doc snippets.
 
@@ -109,7 +107,7 @@ to set many options:
   -v, --verbose         Enable verbose output [env var: AIDER_VERBOSE]
 ```
 
-## Chat commands
+## In chat commands
 
 `aider` supports the following commands from within the chat: