diff --git a/README.md b/README.md
index f8a5050e7..4c967aebc 100644
--- a/README.md
+++ b/README.md
@@ -3,10 +3,10 @@ Docker Compose
 ![Docker Compose](logo.png?raw=true "Docker Compose Logo")
 
 Compose is a tool for defining and running multi-container Docker applications.
-With Compose, you define a multi-container application in a compose
-file then, using a single command, you create and start all the containers
+With Compose, you use a Compose file to configure your application's services.
+Then, using a single command, you create and start all the services
 from your configuration. To learn more about all the features of Compose
-see [the list of features](#features)
+see [the list of features](docs/index.md#features).
 
 Compose is great for development, testing, and staging environments, as well as
 CI workflows. You can learn more about each case in
diff --git a/docs/index.md b/docs/index.md
index ebc1320ea..279154eef 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,10 +12,10 @@ parent="smn_workw_compose"
 # Overview of Docker Compose
 
 Compose is a tool for defining and running multi-container Docker applications.
-With Compose, you define a multi-container application in a compose
-file then, using a single command, you create and start all the containers
+With Compose, you use a Compose file to configure your application's services.
+Then, using a single command, you create and start all the services
 from your configuration. To learn more about all the features of Compose
-see [the list of features](#features)
+see [the list of features](#features).
 
 Compose is great for development, testing, and staging environments, as well as
 CI workflows. You can learn more about each case in