improved Compose samples overview page (#3212)

Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>

_data/toc.yaml

@@ -29,7 +29,7 @@ guides:
     - path: /edge/engine/reference/commandline/docker/
       title: Docker Edge CLI reference
       nosync: true
-    - path: /engine/userguide/eng-image/multistage-build/		
+    - path: /engine/userguide/eng-image/multistage-build/
       title: Use multi-stage builds (Edge only)
   - path: /docker-for-mac/install/
     title: Docker for Mac
@@ -475,7 +475,7 @@ reference:
     title: Get started
   - path: /engine/api/sdks/
     title: SDKs
-  - path: /engine/api/v1.29/		
+  - path: /engine/api/v1.29/
     title: v1.29 Reference
   - sectiontitle: Previous API versions
     section:
@@ -1492,8 +1492,8 @@ manuals:
     title: Link environment variables (deprecated)
   - path: /compose/startup-order/
     title: Control startup order
-  - path: /compose/samples-for-compose/		
-    title: Samples for Compose
+  - path: /compose/samples-for-compose/
+    title: Samples apps with Compose
 - sectiontitle: Docker Datacenter
   section:
   - path: /datacenter/install/aws/

compose/samples-for-compose.md

@@ -1,11 +1,14 @@
 ---
 description: Summary of samples related to Compose
 keywords: documentation, docs, docker, compose, samples
-title: Samples for Compose
-notoc: true
+title: Sample apps with Compose
 ---
 
-The following samples show the various aspects of how to work with Docker Compose. As a prerequisite, be sure to [install Docker Compose](/compose/install/) if you have not already done so.
+The following samples show the various aspects of how to work with Docker
+Compose. As a prerequisite, be sure to [install Docker
+Compose](/compose/install/) if you have not already done so.
+
+## Key concepts these samples cover
 
 The samples should help you to:
 
@@ -15,19 +18,23 @@ The samples should help you to:
 - learn how to make calls to your application services from Compose files
 - learn how to deploy applications and services to a [swarm](/engine/swarm.md)
 
+## Samples tailored to demo Compose
+
 These samples focus specifically on Docker Compose:
 
-- [Quickstart: Compose and Django](/compose/django.md) - This quickstart
-guide demonstrates how to use Docker Compose to set up and run a simple
-Django/PostgreSQL app.
+- [Quickstart: Compose and Django](/compose/django.md) - Shows how to use Docker Compose to set up and run a simple Django/PostgreSQL app.
 
-- [Quickstart: Compose and Rails](/compose/rails.md) - This quickstart
-guide will show you how to use Docker Compose to set up and run a Rails/PostgreSQL
-app.
+- [Quickstart: Compose and Rails](/compose/rails.md) - Show how to use
+Docker Compose to set up and run a Rails/PostgreSQL app.
 
-- [Quickstart: Compose and WordPress](/compose/wordpress.md)
+- [Quickstart: Compose and WordPress](/compose/wordpress.md) - Shows how to
+use Docker Compose to set up and run WordPress in an isolated environment
+with Docker containers.
 
-These samples include working with Docker Compose as part of broader learning goals:
+## Samples that include Compose in the workflows
+
+These samples include working with Docker Compose as part of broader learning
+goals:
 
 - [Get Started with Docker](/get-started/index.md) - This multi-part tutorial covers writing your first app, data storage, networking, and swarms,
 and ends with your app running on production servers in the cloud.