site: use content adapters for cli reference

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

Author: dvdksn

CONTRIBUTING.md

@@ -111,14 +111,17 @@ If this command doesn't result in any errors, you're good to go!
 
 ## Content not edited here
 
-CLI reference documentation is maintained in upstream repositories. It's
-partially generated from code, and is only vendored here for publishing. To
-update the CLI reference docs, refer to the corresponding repository:
+CLI reference documentation is maintained in upstream repositories and
+generated from YAML data files in `data/cli/`. A Hugo content adapter
+(`content/reference/cli/_content.gotmpl`) turns these data files into pages
+automatically. To update the CLI reference docs, refer to the corresponding
+repository:
 
 - [docker/cli](https://github.com/docker/cli)
 - [docker/buildx](https://github.com/docker/buildx)
 - [docker/compose](https://github.com/docker/compose)
 - [docker/model-runner](https://github.com/docker/model-runner)
+- [docker/mcp-gateway](https://github.com/docker/mcp-gateway)
 
 Feel free to raise an issue on this repository if you're not sure how to
 proceed, and we'll help out.

content/get-started/docker-concepts/the-basics/what-is-an-image.md

@@ -84,7 +84,7 @@ Follow the instructions to search and pull a Docker image using CLI to view its
 
 ### Search for and download an image
 
-1. Open a terminal and search for images using the [`docker search`](/reference/cli/docker/search.md) command:
+1. Open a terminal and search for images using the [`docker search`](/reference/cli/docker/search/) command:
 
    ```console
    docker search docker/welcome-to-docker
@@ -99,7 +99,7 @@ Follow the instructions to search and pull a Docker image using CLI to view its
 
    This output shows you information about relevant images available on Docker Hub.
 
-2. Pull the image using the [`docker pull`](/reference/cli/docker/image/pull.md) command.
+2. Pull the image using the [`docker pull`](/reference/cli/docker/image/pull/) command.
 
    ```console
    docker pull docker/welcome-to-docker
@@ -127,7 +127,7 @@ Follow the instructions to search and pull a Docker image using CLI to view its
 
 ### Learn about the image
 
-1. List your downloaded images using the [`docker image ls`](/reference/cli/docker/image/ls.md) command:
+1. List your downloaded images using the [`docker image ls`](/reference/cli/docker/image/ls/) command:
 
    ```console
    docker image ls
@@ -146,7 +146,7 @@ Follow the instructions to search and pull a Docker image using CLI to view its
    >
    > The image size represented here reflects the uncompressed size of the image, not the download size of the layers.
 
-2. List the image's layers using the [`docker image history`](/reference/cli/docker/image/history.md) command:
+2. List the image's layers using the [`docker image history`](/reference/cli/docker/image/history/) command:
 
    ```console
    docker image history docker/welcome-to-docker

content/get-started/workshop/08_using_compose.md

@@ -283,7 +283,7 @@ the way you define and share multi-service applications.
 Related information:
  - [Compose overview](/manuals/compose/_index.md)
  - [Compose file reference](/reference/compose-file/_index.md)
- - [Compose CLI reference](/reference/cli/docker/compose/_index.md)
+ - [Compose CLI reference](/reference/cli/docker/compose/)
 
 ## Next steps
 

content/guides/angular/containerize.md

@@ -538,7 +538,7 @@ $ docker compose down
 
 > [!NOTE]
 > For more information about Compose commands, see the [Compose CLI
-> reference](/reference/cli/docker/compose/_index.md).
+> reference](/reference/cli/docker/compose/).
 
 ---
 

content/guides/angular/run-tests.md

@@ -107,7 +107,7 @@ Time:        1.529 s
 
 > [!NOTE]
 > For more information about Compose commands, see the [Compose CLI
-> reference](/reference/cli/docker/compose/_index.md).
+> reference](/reference/cli/docker/compose/).
 
 ---
 

content/guides/cpp/containerize.md

@@ -76,7 +76,7 @@ $ docker compose down
 ```
 
 For more information about Compose commands, see the [Compose CLI
-reference](/reference/cli/docker/compose/_index.md).
+reference](/reference/cli/docker/compose/).
 
 ## Summary
 

content/guides/dotnet/containerize.md

@@ -210,7 +210,7 @@ $ docker compose down
 ```
 
 For more information about Compose commands, see the [Compose CLI
-reference](/reference/cli/docker/compose/_index.md).
+reference](/reference/cli/docker/compose/).
 
 ## Summary
 

content/guides/genai-pdf-bot/containerize.md

@@ -133,7 +133,7 @@ application using Docker.
 
 Related information:
 
-- [docker init CLI reference](../../../reference/cli/docker/init.md)
+- [docker init CLI reference](/reference/cli/docker/init/)
 
 ## Next steps
 

content/guides/java/containerize.md

@@ -317,7 +317,7 @@ $ docker compose down
 ```
 
 For more information about Compose commands, see the
-[Compose CLI reference](/reference/cli/docker/compose/_index.md).
+[Compose CLI reference](/reference/cli/docker/compose/).
 
 ## Summary
 

content/guides/nodejs/containerize.md

@@ -829,7 +829,7 @@ $ docker compose down
 
 > [!NOTE]
 > For more information about Compose commands, see the [Compose CLI
-> reference](/reference/cli/docker/compose/_index.md).
+> reference](/reference/cli/docker/compose/).
 
 ---