Touch up intro paragraph with feedback from @moxiegirl.

Signed-off-by: Daniel Nephin <[email protected]>

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

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