ENGDOCS-2079 (#19939)

* ENGDOCS-2079

* Fix links

* Fix links

* Fix links

* Fix links

Author: aevesdocker

content/compose/compose-file/compose-file-v2.md

@@ -0,0 +1,13 @@
+---
+title: Legacy versions
+description:
+keywords: fig, composition, compose, versions, upgrading, docker, version 3, docker compose 3
+aliases:
+- /compose/compose-file/compose-versioning/
+- /compose/compose-file/compose-file-v3/
+- /compose/compose-file/compose-file-v2/
+---
+
+The legacy versions of the Compose file reference has moved to the [V1 branch of the Compose repository](https://github.com/docker/compose/tree/v1/docs). They are no longer being actively maintained. 
+
+The latest and recommended version of the Compose file format is defined by the [Compose Specification](_index.md). This format merges the 2.x and 3.x versions and is implemented by **Compose 1.27.0+**. For more information, see the[History and development of Docker Compose](../intro/history.md). 

content/compose/compose-file/compose-file-v3.md

@@ -34,9 +34,9 @@ Compose V2 ignores the `version` top-level element in the `compose.yml` file.
 The Docker Compose CLIs are defined by specific file formats. 
 
 Three major versions of the Compose file format for Compose V1 were released:
-- [Compose file format 1](../compose-file/compose-versioning.md##version-1-to-2x) with Compose 1.0.0 in 2014
-- [Compose file format 2.x](../compose-file/compose-file-v2.md) with Compose 1.6.0 in 2016
-- [Compose file format 3.x](../compose-file/compose-file-v3.md) with Compose 1.10.0 in 2017
+- Compose file format 1 with Compose 1.0.0 in 2014
+- Compose file format 2.x with Compose 1.6.0 in 2016
+- Compose file format 3.x with Compose 1.10.0 in 2017
 
 Compose file format 1 is substantially different to all the following formats as it lacks a top-level `services` key.
 Its usage is historical and files written in this format don't run with Compose V2.

content/compose/compose-file/compose-versioning.md

@@ -2209,7 +2209,7 @@ naming scheme accordingly before upgrading.
 
 - Added support for `extra_hosts` in build configuration
 
-- Added support for the [long syntax](compose-file/compose-file-v3.md#long-syntax-3) for volume entries, as previously introduced in the 3.2 format.
+- Added support for the [long syntax](compose-file/legacy-versions.md) for volume entries, as previously introduced in the 3.2 format.
   Using this syntax will create [mounts](../storage/bind-mounts.md) instead of volumes.
 
 #### Compose file version 2.1 and up
@@ -3145,7 +3145,7 @@ naming scheme accordingly before upgrading.
     You don't have to use it - your existing Compose files will run on Compose
     1.6 exactly as they do today.
 
-    Check the [upgrade guide](../compose/compose-file/compose-versioning.md#upgrading)
+    Check the [upgrade guide](../compose/compose-file/legacy-versions.md)
     for full details.
 
 -   Support for networking has exited experimental status and is the recommended

content/compose/compose-file/legacy-versions.md

@@ -133,7 +133,7 @@ Docker configs.
 
 The `docker stack` command supports defining configs in a Compose file.
 However, the `configs` key is not supported for `docker compose`. See
-[the Compose file reference](../../compose/compose-file/compose-file-v3.md#configs) for details.
+[the Compose file reference](../../compose/compose-file/legacy-versions.md) for details.
 
 ### Simple example: Get started with configs
 

content/compose/intro/history.md

@@ -143,7 +143,7 @@ a similar way, see
 
 Both the `docker-compose` and `docker stack` commands support defining secrets
 in a compose file. See
-[the Compose file reference](../../compose/compose-file/compose-file-v3.md#secrets) for details.
+[the Compose file reference](../../compose/compose-file/legacy-versions.md) for details.
 
 ### Simple example: Get started with secrets
 

content/compose/release-notes.md

@@ -6,7 +6,7 @@ title: Deploy a stack to a swarm
 
 When running Docker Engine in swarm mode, you can use `docker stack deploy` to
 deploy a complete application stack to the swarm. The `deploy` command accepts
-a stack description in the form of a [Compose file](../../compose/compose-file/compose-file-v3.md).
+a stack description in the form of a [Compose file](../../compose/compose-file/legacy-versions.md).
 
 {{< include "swarm-compose-compat.md" >}}