diff --git a/compose/compose-file/compose-file-v1.md b/compose/compose-file/compose-file-v1.md
index bfab802906..6c53cca430 100644
--- a/compose/compose-file/compose-file-v1.md
+++ b/compose/compose-file/compose-file-v1.md
@@ -7,6 +7,11 @@ toc_min: 1
 sitemap: false
 ---
 
+>**Deprecated**
+>
+> Docker Compose file version 1 has been deprecated. We recommend that you move to the latest Compose specification. For more information, see [Compose file reference](index.md).
+{: .warning }
+
 ## Reference and guidelines
 
 These topics describe version 1 of the Compose file format. This is the oldest
diff --git a/compose/compose-file/index.md b/compose/compose-file/index.md
index bd9dbfeecc..af67d651a4 100644
--- a/compose/compose-file/index.md
+++ b/compose/compose-file/index.md
@@ -11,12 +11,12 @@ toc_min: 1
 ## Reference and guidelines
 
 These topics describe the Docker Compose implementation of the Compose format.
-Docker Compose **1.27.0+** implements the format defined by the [Compose Specification](https://github.com/compose-spec/compose-spec/blob/master/spec.md). Previous Docker Compose versions have support for several Compose file formats – 1, 2, 2.x, and 3.x. The Compose specification is an unified 2.x and 3.x file format, aggregating properties accross these formats.
+Docker Compose **1.27.0+** implements the format defined by the [Compose Specification](https://github.com/compose-spec/compose-spec/blob/master/spec.md). Previous Docker Compose versions have support for several Compose file formats – 2, 2.x, and 3.x. The Compose specification is an unified 2.x and 3.x file format, aggregating properties across these formats.
 
 ## Compose and Docker compatibility matrix
 
 There are several versions of the Compose file format – 1, 2, 2.x, and 3.x. The
-table below is a quick look. For full details on what each version includes and
+table below provides a snapshot of various versions. For full details on what each version includes and
 how to upgrade, see **[About versions and upgrading](compose-versioning.md)**.
 
 {% include content/compose-matrix.md %}