Merge pull request #20999 from dvdksn/guides-filters

site: use filter-based nav for guides

Author: dvdksn

static/assets/images/thumbnail.webp renamed to assets/images/thumbnail.webp

@@ -51,7 +51,3 @@ Docker recommends watching the video workshop from DockerCon 2022. Watch the ent
 If you'd like to see how containers are built from scratch, Liz Rice from Aqua Security has a fantastic talk in which she creates a container from scratch in Go. While the talk does not go into networking, using images for the filesystem, and other advanced topics, it gives a deep dive into how things are working.
 
 <iframe src="https://www.youtube-nocookie.com/embed/8fi7uSYlOdc" style="max-width: 100%; aspect-ratio: 16 / 9;" width="560" height="auto" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
-
-## Language-specific guides
-
-If you are looking for information on how to containerize an application using your favorite language, see the [Language-specific guides](/guides/language/_index.md).

content/guides/resources.md renamed to content/get-started/resources.md

@@ -4,42 +4,9 @@ keywords: Docker guides
 description: Explore the Docker guides
 params:
   icon: developer_guide
-  notoc: true
-  dive-deeper:
-  - title: Language-specific guides
-    description: Learn how to containerize, develop, and test language-specific apps using Docker.
-    link: /language/
-    icon: code
-  - title: Use-case guides
-    description: Walk through practical Docker applications for specific scenarios.
-    link: /guides/use-case/
-    icon: task
-  - title: Deployment and Orchestration
-    description: Deploy and manage Docker containers at scale.
-    link: /guides/deployment-orchestration/orchestration/
-    icon: workspaces
-  resources:
-  - title: Educational resources
-    description: Explore diverse Docker training and hands-on experiences.
-    link: /guides/resources/
-    icon: book
-  - title: Contribute to Docker's docs
-    description: Learn how to help contribute to Docker docs.
-    link: /contribute/
-    icon: edit
-layout: wide
+layout: landing
+aliases:
+  - /learning-paths/
 ---
 
 This section contains more advanced guides to help you learn how Docker can optimize your development workflows.
-
-## Advancing with Docker
-
-Explore more advanced concepts and scenarios in Docker.
-
-{{< grid items="dive-deeper" >}}
-
-## Educational resources and contributions
-
-Discover community-driven resources and learn how to contribute to Docker docs.
-
-{{< grid items="resources" >}}

content/get-started/workshop/10_what_next.md

@@ -1,12 +1,21 @@
 ---
-description: Containerize and develop C++ applications using Docker.
-keywords: getting started, c++
 title: C++ language-specific guide
 linkTitle: C++
+description: Containerize and develop C++ applications using Docker.
+keywords: getting started, c++
+summary: |
+  This guide explains how to containerize C++ applications using Docker,
+  covering how to build Docker images, manage dependencies, and deploy C++ apps
+  efficiently in containers.
 toc_min: 1
 toc_max: 2
 aliases:
-- /language/cpp/
+  - /language/cpp/
+  - /guides/language/cpp/
+languages: [cpp]
+levels: [beginner]
+params:
+  time: 10 minutes
 ---
 
 The C++ getting started guide teaches you how to create a containerized C++ application using Docker. In this guide, you'll learn how to:
@@ -15,13 +24,11 @@ The C++ getting started guide teaches you how to create a containerized C++ appl
 >
 > Docker would like to thank [Pradumna Saraf](https://twitter.com/pradumna_saraf) for his contribution to this guide.
 
-* Containerize and run a C++ application
-* Set up a local environment to develop a C++ application using containers
-* Configure a CI/CD pipeline for a containerized C++ application using GitHub Actions
-* Deploy your containerized application locally to Kubernetes to test and debug your deployment
+- Containerize and run a C++ application
+- Set up a local environment to develop a C++ application using containers
+- Configure a CI/CD pipeline for a containerized C++ application using GitHub Actions
+- Deploy your containerized application locally to Kubernetes to test and debug your deployment
 
 After completing the C++ getting started modules, you should be able to containerize your own C++ application based on the examples and instructions provided in this guide.
 
 Start by containerizing an existing C++ application.
-
-{{< button text="Containerize a C++ app" url="containerize.md" >}}

content/guides/_index.md

@@ -5,7 +5,8 @@ weight: 40
 keywords: ci/cd, github actions, c++, shiny
 description: Learn how to configure CI/CD using GitHub Actions for your C++ application.
 aliases:
-- /language/cpp/configure-ci-cd/
+  - /language/cpp/configure-ci-cd/
+  - /guides/language/cpp/configure-ci-cd/
 ---
 
 ## Prerequisites
@@ -69,27 +70,24 @@ to Docker Hub.
 
    ```yaml
    name: ci
-   
+
    on:
      push:
        branches:
          - main
-   
+
    jobs:
      build:
        runs-on: ubuntu-latest
        steps:
-         -
-           name: Login to Docker Hub
+         - name: Login to Docker Hub
            uses: docker/login-action@v3
            with:
              username: ${{ vars.DOCKER_USERNAME }}
              password: ${{ secrets.DOCKERHUB_TOKEN }}
-         -
-           name: Set up Docker Buildx
+         - name: Set up Docker Buildx
            uses: docker/setup-buildx-action@v3
-         -
-           name: Build and push
+         - name: Build and push
            uses: docker/build-push-action@v6
            with:
              platforms: linux/amd64,linux/arm64
@@ -123,11 +121,10 @@ Save the workflow file and run the job.
 In this section, you learned how to set up a GitHub Actions workflow for your C++ application.
 
 Related information:
- - [Introduction to GitHub Actions](/manuals/build/ci/github-actions/_index.md)
- - [Workflow syntax for GitHub Actions](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions)
+
+- [Introduction to GitHub Actions](/manuals/build/ci/github-actions/_index.md)
+- [Workflow syntax for GitHub Actions](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions)
 
 ## Next steps
 
 Next, learn how you can locally test and debug your workloads on Kubernetes before deploying.
-
-{{< button text="Test your deployment" url="./deploy.md" >}}

content/guides/language/cpp/_index.md renamed to content/guides/cpp/_index.md

@@ -5,12 +5,13 @@ weight: 10
 keywords: C++, containerize, initialize
 description: Learn how to containerize a C++ application.
 aliases:
-- /language/cpp/containerize/
+  - /language/cpp/containerize/
+  - /guides/language/cpp/containerize/
 ---
 
 ## Prerequisites
 
-* You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
+- You have a [Git client](https://git-scm.com/downloads). The examples in this section use a command-line based Git client, but you can use any client.
 
 ## Overview
 
@@ -38,9 +39,10 @@ directory.
 ```
 
 To learn more about the files in the repository, see the following:
- - [Dockerfile](/reference/dockerfile.md)
- - [.dockerignore](/reference/dockerfile.md#dockerignore-file)
- - [compose.yml](/reference/compose-file/_index.md)
+
+- [Dockerfile](/reference/dockerfile.md)
+- [.dockerignore](/reference/dockerfile.md#dockerignore-file)
+- [compose.yml](/reference/compose-file/_index.md)
 
 ## Run the application
 
@@ -67,7 +69,6 @@ $ docker compose up --build -d
 
 Open a browser and view the application at [http://localhost:8080](http://localhost:8080).
 
-
 In the terminal, run the following command to stop the application.
 
 ```console
@@ -83,11 +84,10 @@ In this section, you learned how you can containerize and run your C++
 application using Docker.
 
 Related information:
- - [Docker Compose overview](/manuals/compose/_index.md)
+
+- [Docker Compose overview](/manuals/compose/_index.md)
 
 ## Next steps
 
 In the next section, you'll learn how you can develop your application using
 containers.
-
-{{< button text="Develop your application" url="develop.md" >}}

content/guides/language/cpp/configure-ci-cd.md renamed to content/guides/cpp/configure-ci-cd.md

@@ -5,7 +5,8 @@ weight: 50
 keywords: deploy, kubernetes, c++
 description: Learn how to develop locally using Kubernetes
 aliases:
-- /language/cpp/deploy/
+  - /language/cpp/deploy/
+  - /guides/language/cpp/deploy/
 ---
 
 ## Prerequisites
@@ -42,9 +43,9 @@ spec:
         service: ok-api
     spec:
       containers:
-       - name: ok-api-service
-         image: DOCKER_USERNAME/REPO_NAME
-         imagePullPolicy: Always
+        - name: ok-api-service
+          image: DOCKER_USERNAME/REPO_NAME
+          imagePullPolicy: Always
 ---
 apiVersion: v1
 kind: Service
@@ -56,21 +57,21 @@ spec:
   selector:
     service: ok-api
   ports:
-  - port: 8080
-    targetPort: 8080
-    nodePort: 30001
+    - port: 8080
+      targetPort: 8080
+      nodePort: 30001
 ```
 
 In this Kubernetes YAML file, there are two objects, separated by the `---`:
 
- - A Deployment, describing a scalable group of identical pods. In this case,
-   you'll get just one replica, or copy of your pod. That pod, which is
-   described under `template`, has just one container in it. The
-    container is created from the image built by GitHub Actions in [Configure CI/CD for
-    your C++ application](configure-ci-cd.md).
- - A NodePort service, which will route traffic from port 30001 on your host to
-   port 8080 inside the pods it routes to, allowing you to reach your app
-   from the network.
+- A Deployment, describing a scalable group of identical pods. In this case,
+  you'll get just one replica, or copy of your pod. That pod, which is
+  described under `template`, has just one container in it. The
+  container is created from the image built by GitHub Actions in [Configure CI/CD for
+  your C++ application](configure-ci-cd.md).
+- A NodePort service, which will route traffic from port 30001 on your host to
+  port 8080 inside the pods it routes to, allowing you to reach your app
+  from the network.
 
 To learn more about Kubernetes objects, see the [Kubernetes documentation](https://kubernetes.io/docs/home/).
 
@@ -133,9 +134,10 @@ To learn more about Kubernetes objects, see the [Kubernetes documentation](https
 
 ## Summary
 
-In this section, you learned how to use Docker Desktop to deploy your C++ application to a fully-featured Kubernetes environment on your development machine. 
+In this section, you learned how to use Docker Desktop to deploy your C++ application to a fully-featured Kubernetes environment on your development machine.
 
 Related information:
-   - [Kubernetes documentation](https://kubernetes.io/docs/home/)
-   - [Deploy on Kubernetes with Docker Desktop](/manuals/desktop/kubernetes.md)
-   - [Swarm mode overview](/manuals/engine/swarm/_index.md)
+
+- [Kubernetes documentation](https://kubernetes.io/docs/home/)
+- [Deploy on Kubernetes with Docker Desktop](/manuals/desktop/kubernetes.md)
+- [Swarm mode overview](/manuals/engine/swarm/_index.md)

content/guides/language/cpp/containerize.md renamed to content/guides/cpp/containerize.md

@@ -5,7 +5,8 @@ weight: 20
 keywords: C++, local, development
 description: Learn how to develop your C++ application locally.
 aliases:
-- /language/cpp/develop/
+  - /language/cpp/develop/
+  - /guides/language/cpp/develop/
 ---
 
 ## Prerequisites
@@ -66,12 +67,11 @@ Press `ctrl+c` in the terminal to stop your application.
 In this section, you also learned how to use Compose Watch to automatically rebuild and run your container when you update your code.
 
 Related information:
- - [Compose file reference](/reference/compose-file/)
- - [Compose file watch](/manuals/compose/how-tos/file-watch.md)
- - [Multi-stage builds](/manuals/build/building/multi-stage.md)
+
+- [Compose file reference](/reference/compose-file/)
+- [Compose file watch](/manuals/compose/how-tos/file-watch.md)
+- [Multi-stage builds](/manuals/build/building/multi-stage.md)
 
 ## Next steps
 
 In the next section, you'll take a look at how to set up a CI/CD pipeline using GitHub Actions.
-
-{{< button text="Configure CI/CD" url="configure-ci-cd.md" >}}