ENGDOCS-2185 (#20655)

* ENGDOCS-2185

* fix

* silly mistake

* rename getting-started to introduction

* fix

* final fix

* formtatting

* review edits

* review edits

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

---------

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

content/build/ci/github-actions/build-summary.md

@@ -45,7 +45,7 @@ the [Docker Desktop **Builds** view](../../../desktop/use-desktop/builds.md).
 
 To import the build record archive into Docker Desktop:
 
-1. Download and install [Docker Desktop](../../../get-docker.md).
+1. Download and install [Docker Desktop](/get-started/get-docker.md).
 
 2. Download the build record archive from the job summary in GitHub Actions.
 

content/build/guide/intro.md

@@ -12,7 +12,7 @@ you can improve how you build the application with Docker.
 
 To follow this guide:
 
-1. Install [Docker Desktop or Docker Engine](../../get-docker.md)
+1. Install [Docker Desktop or Docker Engine](/get-started/get-docker.md)
 2. Clone or create a new repository from the
    [application example on GitHub](https://github.com/dockersamples/buildme)
 

content/desktop/install/archlinux.md

@@ -52,7 +52,7 @@ $ sudo pacman -S gnome-terminal
 ## Next steps
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
 - [FAQs](../faqs/general.md) provide answers to frequently asked questions.

content/desktop/install/debian.md

@@ -85,7 +85,7 @@ Don't forget to substitute `<arch>` with the architecture you want.
 ## Next steps
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
 - [FAQs](../faqs/general.md) provide answers to frequently asked questions.

content/desktop/install/fedora.md

@@ -77,7 +77,7 @@ Don't forget to substitute `<arch>` with the architecture you want.
 ## Next steps
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
 - [FAQs](../faqs/general.md) provide answers to frequently asked questions.

content/desktop/install/mac-install.md

@@ -125,7 +125,7 @@ The `install` command accepts the following flags:
 ## Where to go next 
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you. 
-- [Get started with Docker](../../guides/getting-started/_index.md).
+- [Get started with Docker](/get-started/introduction/_index.md).
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how
   to run and submit diagnostics, and submit issues.

content/desktop/install/rhel.md

@@ -135,7 +135,7 @@ $ sudo dnf install ./docker-desktop-<arch>-rhel.rpm
 ## Next steps
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
 - [FAQs](../faqs/general.md) provide answers to frequently asked questions.

content/desktop/install/ubuntu.md

@@ -90,7 +90,7 @@ Don't forget to substitute `<arch>` with the architecture you want.
 ## Next steps
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- Take a look at the [Docker workshop](../../guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
 - [FAQs](../faqs/general.md) provide answers to frequently asked questions.

content/desktop/install/windows-install.md

@@ -275,7 +275,7 @@ Docker Desktop does not start automatically after installation. To start Docker
 ## Where to go next
 
 - Explore [Docker's core subscriptions](https://www.docker.com/pricing/) to see what Docker can offer you.
-- [Get started with Docker](../../guides/getting-started/_index.md).
+- [Get started with Docker](/get-started/introduction/_index.md).
 - [Explore Docker Desktop](../use-desktop/index.md) and all its features.
 - [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, and
   how to get support.

content/desktop/use-desktop/_index.md

@@ -26,7 +26,7 @@ In addition, the Docker Dashboard allows you to:
 - Be notified of new releases, installation progress updates, and more in the **Notifications center**. Select the bell icon in the bottom-right corner of the Docker Dashboard to access the notification center.
 - Access the **Learning center** from the Dashboard header. It helps you get started with quick in-app walkthroughs and provides other resources for learning about Docker. 
 
-  For a more detailed guide about getting started, see [Get started](../../guides/getting-started/_index.md).
+  For a more detailed guide about getting started, see [Get started](/get-started/introduction/_index.md).
 - Get to the [Docker Scout](../../scout/_index.md) dashboard.
 - Check the status of Docker services.
 

content/desktop/use-desktop/container.md

@@ -122,5 +122,5 @@ can also:
 
 ## Additional resources
 
-- [What is a container](../../guides/docker-concepts/the-basics/what-is-a-container.md)
+- [What is a container](/get-started/docker-concepts/the-basics/what-is-a-container.md)
-- [Run multi-container applications](../../guides/docker-concepts/running-containers/multi-container-applications.md)
+- [Run multi-container applications](/get-started/docker-concepts/running-containers/multi-container-applications.md)

content/desktop/use-desktop/images.md

@@ -102,4 +102,4 @@ Hovering over an image tag reveals two options:
 
 ## Additional resources
 
-- [What is an image?](../../guides/docker-concepts/the-basics/what-is-an-image.md)
+- [What is an image?](/get-started/docker-concepts/the-basics/what-is-an-image.md)

content/desktop/use-desktop/volumes.md

@@ -244,5 +244,5 @@ To import a volume:
 
 ## Additional resources
 
-- [Persisting container data](../../guides/docker-concepts/running-containers/persisting-container-data.md)
+- [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data.md)
 - [Use volumes](/engine/storage/volumes.md)

content/docker-hub/vulnerability-scanning.md

@@ -81,7 +81,7 @@ To enable static vulnerability scanning:
 To scan an image for vulnerabilities, push the image to Docker Hub, to the
 repository for which you have turned on scanning:
 
-1. Ensure you have installed Docker locally. See [Get Docker](../get-docker.md)
+1. Ensure you have installed Docker locally. See [Get Docker](/get-started/get-docker.md)
    to download and install Docker on your local machine.
 2. Use the command line to log into your Docker account. See
    [`docker login`](../reference/cli/docker/login.md) for more

content/engine/_index.md

@@ -64,7 +64,7 @@ use the underlying API and CLI. The daemon creates and manages Docker objects,
 such as images, containers, networks, and volumes.
 
 For more details, see
-[Docker Architecture](../guides/docker-overview.md#docker-architecture).
+[Docker Architecture](/get-started/docker-overview.md#docker-architecture).
 
 {{< grid >}}
 

content/engine/api/sdk/examples.md

@@ -12,7 +12,7 @@ aliases:
 ---
 
 After you
-[install Docker](../../../get-docker.md), you can
+[install Docker](/get-started/get-docker.md), you can
 [install the Go or Python SDK](index.md#install-the-sdks) and
 also try out the Docker Engine API.
 

content/engine/install/_index.md

@@ -123,4 +123,4 @@ Security reports are greatly appreciated, and Docker will publicly thank you for
 ## Get started
 
 After setting up Docker, you can learn the basics with
-[Getting started with Docker](../../guides/getting-started/_index.md).
+[Getting started with Docker](/get-started/introduction/_index.md).

content/engine/install/linux-postinstall.md

@@ -139,4 +139,4 @@ options:
 
 ## Next steps
 
-- Take a look at the [Docker workshop](/guides/workshop/_index.md) to learn how to build an image and run it as a containerized application.
+- Take a look at the [Docker workshop](/get-started/workshop/_index.md) to learn how to build an image and run it as a containerized application.

content/engine/release-notes/18.06.md

@@ -51,7 +51,7 @@ toc_max: 2
 
 ### Important notes about this release
 
-- Docker 18.06 CE will be the last release with a 4-month maintenance lifecycle. The planned Docker 18.09 CE release will be supported for 7 months with Docker 19.03 CE being the next release in line. More details about the release process can be found [here](../../get-docker.md).
+- Docker 18.06 CE will be the last release with a 4-month maintenance lifecycle. The planned Docker 18.09 CE release will be supported for 7 months with Docker 19.03 CE being the next release in line. More details about the release process can be found [here](/get-started/get-docker.md).
 
 ### Builder
 

content/engine/tutorials/_index.md

@@ -12,4 +12,4 @@ Learn by example:
 * [Network containers](networkingcontainers.md)
 * [Manage data in containers](/engine/storage/volumes.md)
 * [Samples](../../samples/index.md)
-* [Get Started](../../guides/getting-started/_index.md)
+* [Get Started](/get-started/introduction/_index.md)

content/get-started/_index.md

@@ -0,0 +1,32 @@
+---
+title: Get started
+keywords: Docker, get started
+description: Get started with Docker
+notoc: true
+
+get-started:
+- title: Docker overview
+  description: Learn about the Docker platform.
+  link: /get-started/docker-overview/
+  icon: summarize
+- title: Introduction
+  description: Get started with the basics and the benefits of containerizing your applications.
+  link: /get-started/introduction/
+  icon: rocket
+- title: Docker concepts
+  description: Gain a better understanding of foundational Docker concepts.
+  link: /get-started/docker-concepts/the-basics/what-is-a-container/
+  icon: foundation
+- title: Docker workshop
+  description: Get guided through a 45-minute workshop to learn about Docker.
+  link: /get-started/workshop/
+  icon: desk
+---
+
+This section contains guides to help you get started and learn how Docker can optimize your development workflows. For more advanced concepts and scenarios in Docker, see [Guides](/guides/).
+
+## Foundations of Docker
+
+Get started learning the foundational concepts and workflows of Docker.
+
+{{< grid items="get-started" >}}

content/get-started/docker-concepts/building-images/build-tag-and-publish-an-image.md

@@ -7,6 +7,8 @@ summary: |
   containerization workflow. In this guide, you’ll learn how to create Docker
   images, how to tag those images with a unique identifier, and how to publish
   your image to a public registry.
+aliases: 
+ - /guides/docker-concepts/building-images/build-tag-and-publish-an-image/
 ---
 
 {{< youtube-embed chiiGLlYRlY >}}
@@ -221,7 +223,7 @@ To learn more about building, tagging, and publishing images, visit the followin
 * [docker build reference](/engine/reference/commandline/image_build/)
 * [docker image tag reference](/engine/reference/commandline/image_tag/)
 * [docker push reference](/engine/reference/commandline/image_push/)
-* [What is a registry?](/guides/docker-concepts/the-basics/what-is-a-registry/)
+* [What is a registry?](/get-started/docker-concepts/the-basics/what-is-a-registry/)
 
 ## Next steps
 

content/get-started/docker-concepts/building-images/multi-stage-builds.md

@@ -8,6 +8,8 @@ summary: |
   you'll unlock the power of multi-stage builds to create lean and efficient
   Docker images, essential for minimizing overhead and enhancing deployment in
   production environments.
+aliases: 
+ - /guides/docker-concepts/building-images/multi-stage-builds/
 ---
 
 {{< youtube-embed vR185cjwxZ8 >}}

content/get-started/docker-concepts/building-images/understanding-image-layers.md

@@ -7,6 +7,8 @@ summary: |
   understand image layers - the fundamental building blocks of container
   images. You'll gain a comprehensive understanding of how layers are created,
   stacked, and utilized to ensure efficient and optimized containers.
+aliases: 
+ - /guides/docker-concepts/building-images/understanding-image-layers/
 ---
 
 {{< youtube-embed wJwqtAkmtQA >}}

content/get-started/docker-concepts/building-images/using-the-build-cache.md

@@ -9,6 +9,8 @@ summary: |
   rebuilds, it's crucial to understand how cache invalidation works. In this
   guide, you’ll learn how to use the Docker build cache efficiently for
   streamlined Docker image development and continuous integration workflows.
+aliases: 
+ - /guides/docker-concepts/building-images/using-the-build-cache/
 ---
 
 {{< youtube-embed Ri6jMknjprY >}}

content/get-started/docker-concepts/building-images/writing-a-dockerfile.md

@@ -8,6 +8,8 @@ summary: |
   CI/CD methodologies. In this guide, you’ll learn how to write a Dockerfile,
   how to define a base image and setup instructions, including software
   installation and copying necessary files.
+aliases: 
+ - /guides/docker-concepts/building-images/writing-a-dockerfile/
 ---
 
 {{< youtube-embed Jx8zoIhiP4c >}}

content/get-started/docker-concepts/running-containers/multi-container-applications.md

@@ -2,6 +2,8 @@
 title: Multi-container applications
 keywords: concepts, build, images, container, docker desktop
 description: This concept page will teach you the significance of multi-container application and how it is different from single-container application
+aliases: 
+ - /guides/docker-concepts/running-containers/multi-container-applications/
 ---
 
 {{< youtube-embed 1jUwR6F9hvM >}}
@@ -83,7 +85,7 @@ In this hands-on guide, you'll first see how to build and run a counter web appl
    {{< /tabs >}}
 
 
-2. [Download and install](/get-docker/) Docker Desktop.
+2. [Download and install](/get-started/get-docker.md) Docker Desktop.
 
 ### Build the images
 
@@ -216,5 +218,5 @@ In this guide, you learned how easy it is to use Docker Compose to start and sto
 ## Additional resources
 
 * [`docker container run` CLI reference](reference/cli/docker/container/run/)
-* [What is Docker Compose](/guides/docker-concepts/the-basics/what-is-docker-compose/)
+* [What is Docker Compose](/get-started/docker-concepts/the-basics/what-is-docker-compose/)
 

content/get-started/docker-concepts/running-containers/overriding-container-defaults.md

@@ -2,6 +2,8 @@
 title: Overriding container defaults
 keywords: concepts, build, images, container, docker desktop
 description: This concept page will teach you how to override the container defaults using the `docker run` command.
+aliases: 
+ - /guides/docker-concepts/running-containers/overriding-container-defaults/
 ---
 
 {{< youtube-embed PFszWK3BB8I >}}
@@ -66,7 +68,7 @@ By effectively using these `docker run` flags, you can tailor your containerized
 
 In this hands-on guide, you'll see how to use the `docker run` command to override the container defaults.
 
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
 
 ### Run multiple instance of the Postgres database
 
@@ -196,7 +198,7 @@ This command runs a Postgres container, sets an environment variable for passwor
 ## Additional resources
 
 * [Ways to set environment variables with Compose](/compose/environment-variables/set-environment-variables/)
-* [What is a container](/guides/docker-concepts/the-basics/what-is-a-container/)
+* [What is a container](/get-started/docker-concepts/the-basics/what-is-a-container/)
 
 ## Next steps
 

content/get-started/docker-concepts/running-containers/persisting-container-data.md

@@ -3,7 +3,8 @@ title: Persisting container data
 keywords: concepts, build, images, container, docker desktop
 description: This concept page will teach you the significance of data persistence in Docker
 aliases:
-- /guides/walkthroughs/persist-data/
+ - /guides/walkthroughs/persist-data/
+ - /guides/docker-concepts/running-containers/persisting-container-data/
 ---
 
 {{< youtube-embed 10_2BjqB_Ls >}}
@@ -55,7 +56,7 @@ In this guide, you’ll practice creating and using volumes to persist data crea
 
 ### Use volumes
 
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
 
 2. Start a container using the [Postgres image](https://hub.docker.com/_/postgres) with the following command:
 

content/get-started/docker-concepts/running-containers/publishing-ports.md

@@ -2,6 +2,8 @@
 title: Publishing and exposing ports
 keywords: concepts, build, images, container, docker desktop
 description: This concept page will teach you the significance of publishing and exposing ports in Docker 
+aliases: 
+ - /guides/docker-concepts/running-containers/publishing-ports/
 ---
 
 {{< youtube-embed 9JnqOmJ96ds >}}
@@ -75,7 +77,7 @@ In this hands-on guide, you'll learn how to publish container ports using both t
 
 In this step, you will run a container and publish its port using the Docker CLI.
 
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
 
 2. In a terminal, run the following command to start a new container:
 
@@ -91,7 +93,7 @@ In this step, you will run a container and publish its port using the Docker CLI
 
 4. Open the website by either selecting the link in the **Port(s)** column of your container or visiting [http://localhost:8080](http://localhost:8080) in your browser.
 
-   ![A screenshot of the landing page of the Nginx web server running in a container](/guides/docker-concepts/the-basics/images/access-the-frontend.webp?border=true)
+   ![A screenshot of the landing page of the Nginx web server running in a container](/get-started/docker-concepts/the-basics/images/access-the-frontend.webp?border=true)
 
 
 ### Use Docker Compose

content/get-started/docker-concepts/running-containers/sharing-local-files.md

@@ -2,6 +2,8 @@
 title: Sharing local files with containers
 keywords: concepts, images, container, docker desktop
 description: This concept page will teach you the various storage options available in Docker and their common usage.
+aliases: 
+ - /guides/docker-concepts/running-containers/sharing-local-files/
 ---
 
 {{< youtube-embed 2dAzsVg3Dek >}}
@@ -17,7 +19,7 @@ Docker offers two primary storage options for persisting data and sharing files
 
 ### Volume versus bind mounts
 
-If you want to ensure that data generated or modified inside the container persists even after the container stops running, you would opt for a volume. See [Persisting container data](/guides/docker-concepts/running-containers/persisting-container-data/) to learn more about volumes and their use cases.
+If you want to ensure that data generated or modified inside the container persists even after the container stops running, you would opt for a volume. See [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data/) to learn more about volumes and their use cases.
 
 If you have specific files or directories on your host system that you want to directly share with your container, like configuration files or development code, then you would use a bind mount. It's like opening a direct portal between your host and container for sharing. Bind mounts are ideal for development environments where real-time file access and sharing between the host and container are crucial.
 
@@ -66,7 +68,7 @@ In this hands-on guide, you’ll practice how to create and use a bind mount to
 
 ### Run a container
 
-1. [Download and install](/get-docker/) Docker Desktop.
+1. [Download and install](/get-started/get-docker/) Docker Desktop.
 
 2. Start a container using the [httpd](https://hub.docker.com/_/httpd) image with the following command:
 
@@ -197,7 +199,7 @@ The following resources will help you learn more about bind mounts:
 * [Bind mounts](/storage/bind-mounts/)
 * [Running containers](/reference/run/)
 * [Troubleshoot storage errors](/storage/troubleshooting_volume_errors/)
-* [Persisting container data](/guides/docker-concepts/running-containers/persisting-container-data/)
+* [Persisting container data](/get-started/docker-concepts/running-containers/persisting-container-data/)
 
 ## Next steps
 

content/get-started/docker-concepts/the-basics/what-is-a-container.md

@@ -7,6 +7,7 @@ aliases:
 - /guides/walkthroughs/run-a-container/
 - /guides/walkthroughs/
 - /get-started/run-your-own-container/
+- /guides/docker-concepts/the-basics/what-is-a-container/
 ---
 
 {{< youtube-embed W1kWqFkiu7k >}}

content/get-started/docker-concepts/the-basics/what-is-a-registry.md

@@ -5,6 +5,7 @@ description: What is a registry? This Docker Concept will explain what a registr
 aliases:
 - /guides/walkthroughs/run-hub-images/
 - /guides/walkthroughs/publish-your-image/
+- /guides/docker-concepts/the-basics/what-is-a-registry/
 ---
 
 {{< youtube-embed 2WDl10Wv5rs >}}

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

@@ -2,6 +2,8 @@
 title: What is an image?
 keywords: concepts, build, images, container, docker desktop
 description: What is an image
+aliases: 
+ - /guides/docker-concepts/the-basics/what-is-an-image/
 ---
 
 {{< youtube-embed NyvT9REqLe4 >}}

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

@@ -3,7 +3,8 @@ title: What is Docker Compose?
 keywords: concepts, build, images, container, docker desktop
 description: What is Docker Compose?
 aliases:
-- /guides/walkthroughs/multi-container-apps/
+ - /guides/walkthroughs/multi-container-apps/
+ - /guides/docker-concepts/the-basics/what-is-docker-compose/
 ---
 
 {{< youtube-embed xhcUIK4fGtY >}}

content/get-started/docker-overview.md

@@ -12,6 +12,7 @@ aliases:
 - /engine/understanding-docker/
 - /engine/docker-overview/
 - /get-started/overview/
+- /get-started/docker-overview/
 ---
 
 Docker is an open platform for developing, shipping, and running applications.
@@ -105,7 +106,7 @@ Docker API. The Docker client can communicate with more than one daemon.
 
 ### Docker Desktop
 
-Docker Desktop is an easy-to-install application for your Mac, Windows or Linux environment that enables you to build and share containerized applications and microservices. Docker Desktop includes the Docker daemon (`dockerd`), the Docker client (`docker`), Docker Compose, Docker Content Trust, Kubernetes, and Credential Helper. For more information, see [Docker Desktop](../desktop/index.md).
+Docker Desktop is an easy-to-install application for your Mac, Windows or Linux environment that enables you to build and share containerized applications and microservices. Docker Desktop includes the Docker daemon (`dockerd`), the Docker client (`docker`), Docker Compose, Docker Content Trust, Kubernetes, and Credential Helper. For more information, see [Docker Desktop](/desktop/index.md).
 
 ### Docker registries
 
@@ -202,5 +203,5 @@ in a separate namespace and its access is limited to that namespace.
 
 ## Next steps
 
-- [Install Docker](../get-docker.md)
+- [Install Docker](/get-started/get-docker.md)
-- [Get started with Docker](index.md)
+- [Get started with Docker](/get-started/introduction/_index.md)

content/get-started/get-docker.md

@@ -5,9 +5,10 @@ keywords: install docker, docker download, download docker, docker installation,
   to install docker, get docker, docker locally
 title: Get Docker
 aliases:
-- /install/
+ - /install/
-- /install/overview/
+ - /install/overview/
-- /installation/
+ - /installation/
+ - /get-docker/
 ---
 
 Docker is an open platform for developing, shipping, and running applications.

content/get-started/introduction/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Getting started
+title: Introduction
 keywords: get started, getting started, how to get started
 description: |
   Get started with Docker. You'll learn about Docker Desktop, developing with
@@ -9,13 +9,14 @@ summary: |
   containerization, beginning with foundational concepts and installation
   procedures. Progress through hands-on exercises that cover essential Docker
   commands, image creation, and container orchestration.
-aliases:
-  - /get-started/
 layout: series
 params:
   skill: Beginner
   time: 15 minutes
   prereq: None
+aliases:
+  - /get-started/
+  - /guides/getting-started/
 ---
 
 ## About this series

content/get-started/introduction/build-and-push-first-image.md

@@ -8,6 +8,8 @@ summary: |
   repository and building and pushing your image to Docker Hub. This enables
   you to share your image easily within your team.
 weight: 3
+aliases: 
+ - /guides/getting-started/build-and-push-first-image/
 ---
 
 {{< youtube-embed 7ge1s5nAa34 >}}

content/get-started/introduction/develop-with-containers.md

@@ -8,6 +8,8 @@ summary: |
   backend and frontend code within the containerized environment, ensuring
   seamless integration and testing.
 weight: 2
+aliases:
+ - /guides/getting-started/develop-with-containers/
 ---
 
 {{< youtube-embed D0SDBrS3t9I >}}

content/get-started/introduction/get-docker-desktop.md

@@ -9,6 +9,8 @@ summary: |
   simplifies the process of building, sharing, and running applications in
   containers, ensuring consistency across different environments.
 weight: 1
+aliases:
+ - /getting-started/get-docker-desktop/
 ---
 
 {{< youtube-embed C2bPVhiNU-0 >}}

content/get-started/introduction/whats-next.md

@@ -2,6 +2,8 @@
 title: What's next 
 keywords: concepts, build, images, container, docker desktop
 description: Explore step-by-step guides to hep you understand core Docker concepts, building images, and running containers.
+aliases:
+ - /guides/getting-started/whats-next/
 summary: |
   Now that you have set up Docker Desktop, developed with containers, and built
   and pushed your first image, you are ready to take the next step and dive
@@ -12,50 +14,50 @@ weight: 4
 the-basics:
 - title: What is a container?
   description: Learn how to run your first container.
-  link: /guides/docker-concepts/the-basics/what-is-a-container/
+  link: /get-started/docker-concepts/the-basics/what-is-a-container/
 - title: What is an image?
   description: Learn the basics of image layers. 
-  link: /guides/docker-concepts/the-basics/what-is-an-image/
+  link: /get-started/docker-concepts/the-basics/what-is-an-image/
 - title: What is a registry?
   description: Learn about container registries, explore their interoperability, and interact with registries. 
-  link: /guides/docker-concepts/the-basics/what-is-a-registry/
+  link: /get-started/docker-concepts/the-basics/what-is-a-registry/
 - title: What is Docker Compose?
   description: Gain a better understanding of Docker Compose.
-  link: /guides/docker-concepts/the-basics/what-is-docker-compose/
+  link: /get-started/docker-concepts/the-basics/what-is-docker-compose/
 
 building-images:
 - title: Understanding image layers 
   description: Learn about the layers of container images.
-  link: /guides/docker-concepts/building-images/understanding-image-layers/
+  link: /get-started/docker-concepts/building-images/understanding-image-layers/
 - title: Writing a Dockerfile
   description: Learn how to create an image using a Dockerfile.
-  link: /guides/docker-concepts/building-images/writing-a-dockerfile/
+  link: /get-started/docker-concepts/building-images/writing-a-dockerfile/
 - title: Build, tag and publish an image
   description: Learn how to build, tag, and publish an image to Docker Hub or any other registry.
-  link: /guides/docker-concepts/building-images/build-tag-and-publish-an-image/
+  link: /get-started/docker-concepts/building-images/build-tag-and-publish-an-image/
 - title: Using the build cache
   description: Learn about the build cache, what changes invalidate the cache, and how to effectively use the build cache.
-  link: /guides/docker-concepts/building-images/using-the-build-cache/
+  link: /get-started/docker-concepts/building-images/using-the-build-cache/
 - title: Multi-stage builds
   description: Get a better understanding of multi-stage builds and their benefits.
-  link: /guides/docker-concepts/building-images/multi-stage-builds/
+  link: /get-started/docker-concepts/building-images/multi-stage-builds/
 
 running-containers:
 - title: Publishing ports
   description: Understand the significance of publishing and exposing ports in Docker.
-  link: /guides/docker-concepts/running-containers/publishing-ports/
+  link: /get-started/docker-concepts/running-containers/publishing-ports/
 - title: Overriding container defaults
   description: Learn how to override the container defaults using the `docker run` command.
-  link: /guides/docker-concepts/running-containers/overriding-container-defaults/
+  link: /get-started/docker-concepts/running-containers/overriding-container-defaults/
 - title: Persisting container data
   description: Learn the significance of data persistence in Docker.
-  link: /guides/docker-concepts/running-containers/persisting-container-data/
+  link: /get-started/docker-concepts/running-containers/persisting-container-data/
 - title: Sharing local files with containers
   description: Explore the various storage options available in Docker and their common usage.
-  link: /guides/docker-concepts/running-containers/sharing-local-files/
+  link: /get-started/docker-concepts/running-containers/sharing-local-files/
 - title: Multi-container applications
   description: Learn the significance of multi-container applications and how they're different from single-container applications.
-  link: /guides/docker-concepts/running-containers/multi-container-applications/
+  link: /get-started/docker-concepts/running-containers/multi-container-applications/
 ---
 
 The following sections provide step-by-step guides to help you understand core Docker concepts, building images, and running containers.

content/get-started/workshop/02_our_app.md

@@ -6,8 +6,9 @@ keywords: dockerfile example, Containerize an application, run docker file, runn
 description: Follow this step-by-step guide to learn how to create and run a containerized
   application using Docker
 aliases:
-- /get-started/part2/
+ - /get-started/part2/
-- /get-started/02_our_app/
+ - /get-started/02_our_app/
+ - /guides/workshop/02_our_app/
 ---
 
 For the rest of this guide, you'll be working with a simple todo
@@ -16,7 +17,7 @@ don't worry. This guide doesn't require any prior experience with JavaScript.
 
 ## Prerequisites
 
-- You have installed the latest version of [Docker Desktop](../../get-docker.md).
+- You have installed the latest version of [Docker Desktop](/get-started/get-docker.md).
 - You have installed a [Git client](https://git-scm.com/downloads).
 - You have an IDE or a text editor to edit files. Docker recommends using [Visual Studio Code](https://code.visualstudio.com/).
 
@@ -203,7 +204,7 @@ Related information:
 
  - [Dockerfile reference](/reference/dockerfile/)
  - [docker CLI reference](/reference/cli/docker/)
- - [Build with Docker guide](../../build/guide/_index.md)
+ - [Build with Docker guide](/build/guide/_index.md)
 
 ## Next steps
 

content/get-started/workshop/03_updating_app.md

@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Making changes to your application
 aliases:
-- /get-started/03_updating_app/
+ - /get-started/03_updating_app/
+ - /guides/workshop/03_updating_app/
 ---
 
 In [part 2](./02_our_app.md), you containerized a todo application. In this part, you'll update the application and image. You'll also learn how to stop and remove a container.

content/get-started/workshop/04_sharing_app.md

@@ -5,8 +5,9 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
 description: Sharing your image you built for your example application so you can
   run it else where and other developers can use it
 aliases:
-- /get-started/part3/
+ - /get-started/part3/
-- /get-started/04_sharing_app/
+ - /get-started/04_sharing_app/
+ - /guides/workshop/04_sharing_app/
 ---
 
 Now that you've built an image, you can share it. To share Docker images, you have to use a Docker
@@ -79,7 +80,7 @@ new instance that has never seen this container image. To do this, you will use
 > $ docker build --platform linux/amd64 -t YOUR-USER-NAME/getting-started .
 > ```
 >
-> Docker buildx also supports building multi-platform images. To learn more, see [Multi-platform images](../../build/building/multi-platform.md).
+> Docker buildx also supports building multi-platform images. To learn more, see [Multi-platform images](/build/building/multi-platform.md).
 
 
 1. Open your browser to [Play with Docker](https://labs.play-with-docker.com/).
@@ -128,8 +129,8 @@ can use the latest version of the image.
 Related information:
 
  - [docker CLI reference](/reference/cli/docker/)
- - [Multi-platform images](../../build/building/multi-platform.md)
+ - [Multi-platform images](/build/building/multi-platform.md)
- - [Docker Hub overview](../../docker-hub/_index.md)
+ - [Docker Hub overview](/docker-hub/_index.md)
 
 ## Next steps
 

content/get-started/workshop/05_persisting_data.md

@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Making your DB persistent in your application
 aliases:
-- /get-started/05_persisting_data/
+ - /get-started/05_persisting_data/
+ - /guides/workshop/05_persisting_data/
 ---
 
 In case you didn't notice, your todo list is empty every single time

content/get-started/workshop/06_bind_mounts.md

@@ -3,8 +3,9 @@ title: Use bind mounts
 keywords: 'get started, setup, orientation, quickstart, intro, concepts, containers, docker desktop'
 description: Using bind mounts in our application
 aliases:
-- /guides/walkthroughs/access-local-folder/
+ - /guides/walkthroughs/access-local-folder/
-- /get-started/06_bind_mounts/
+ - /get-started/06_bind_mounts/
+ - /guides/workshop/06_bind_mounts/
 ---
 
 In [part 5](./05_persisting_data.md), you used a volume mount to persist the
@@ -48,9 +49,9 @@ work.
 1. Verify that your `getting-started-app` directory is in a directory defined in
 Docker Desktop's file sharing setting. This setting defines which parts of your
 filesystem you can share with containers. For details about accessing the
-setting, see the topic for [Mac](../../desktop/settings/mac.md/#file-sharing),
+setting, see the topic for [Mac](/desktop/settings/mac.md#file-sharing),
-[Windows](../../desktop/settings/windows.md/#file-sharing), or
+[Windows](/desktop/settings/windows.md#file-sharing), or
-[Linux](../../desktop/settings/linux.md/#file-sharing).
+[Linux](/desktop/settings/linux.md#file-sharing).
 
 2. Open a terminal and change directory to the `getting-started-app`
    directory.

content/get-started/workshop/07_multi_container.md

@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Using more than one container in your application
 aliases:
-- /get-started/07_multi_container/
+ - /get-started/07_multi_container/
+ - /guides/workshop/07_multi_container/
 ---
 
 Up to this point, you've been working with single container apps. But, now you will add MySQL to the

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

@@ -4,10 +4,11 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Using Docker Compose for multi-container applications
 aliases:
-- /get-started/08_using_compose/
+ - /get-started/08_using_compose/
+ - /guides/workshop/08_using_compose/
 ---
 
-[Docker Compose](../../compose/_index.md) is a tool that helps you define and
+[Docker Compose](/compose/_index.md) is a tool that helps you define and
 share multi-container applications. With Compose, you can create a YAML file to define the services
 and with a single command, you can spin everything up or tear it all down.
 
@@ -278,9 +279,9 @@ In this section, you learned about Docker Compose and how it helps you simplify
 the way you define and share multi-service applications.
 
 Related information:
- - [Compose overview](../../compose/_index.md)
+ - [Compose overview](/compose/_index.md)
  - [Compose file reference](/reference/compose-file/_index.md)
- - [Compose CLI reference](../../compose/reference/_index.md)
+ - [Compose CLI reference](/compose/reference/_index.md)
 
 ## Next steps
 

content/get-started/workshop/09_image_best.md

@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Tips for building images for your application
 aliases:
-- /get-started/09_image_best/
+ - /get-started/09_image_best/
+ - /guides/workshop/09_image_best/
 ---
 
 ## Image layering
@@ -200,8 +201,8 @@ In this section, you learned a few image building best practices, including laye
 
 Related information:
  - [Dockerfile reference](/reference/dockerfile/)
- - [Build with Docker guide](../../build/guide/_index.md)
+ - [Build with Docker guide](/build/guide/_index.md)
- - [Dockerfile best practices](../../build/building/best-practices.md)
+ - [Dockerfile best practices](/build/building/best-practices.md)
 
 ## Next steps
 

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

@@ -4,7 +4,8 @@ keywords: get started, setup, orientation, quickstart, intro, concepts, containe
   docker desktop
 description: Making sure you have more ideas of what you could do next with your application
 aliases:
-- /get-started/11_what_next/
+ - /get-started/11_what_next/
+ - /guides/workshop/10_what_next/
 ---
 
 Although you're done with the workshop, there's still a lot more to learn about containers.
@@ -51,4 +52,4 @@ If you'd like to see how containers are built from scratch, Liz Rice from Aqua S
 
 ## Language-specific guides
 
-If you are looking for information on how to containerize an application using your favorite language, see the [Language-specific guides](../../language/_index.md).
+If you are looking for information on how to containerize an application using your favorite language, see the [Language-specific guides](/language/_index.md).

content/get-started/workshop/_index.md

@@ -6,60 +6,9 @@ keywords: docker basics, how to start a docker container, container settings, se
 description: Get started with the Docker basics in this workshop, You'll
   learn about containers, images, and how to containerize your first application.
 aliases:
-- /engine/getstarted-voting-app/
-- /engine/getstarted-voting-app/cleanup/
-- /engine/getstarted-voting-app/create-swarm/
-- /engine/getstarted-voting-app/customize-app/
-- /engine/getstarted-voting-app/deploy-app/
-- /engine/getstarted-voting-app/node-setup/
-- /engine/getstarted-voting-app/test-drive/
-- /engine/getstarted/
-- /engine/getstarted/last_page/
-- /engine/getstarted/step_five/
-- /engine/getstarted/step_four/
-- /engine/getstarted/step_one/
-- /engine/getstarted/step_six/
-- /engine/getstarted/step_three/
-- /engine/getstarted/step_two/
-- /engine/quickstart/
-- /engine/tutorials/
-- /engine/tutorials/dockerimages/
-- /engine/tutorials/dockerizing/
-- /engine/tutorials/usingdocker/
-- /engine/userguide/containers/dockerimages/
-- /engine/userguide/dockerimages/
-- /engine/userguide/intro/
-- /get-started/part1/
-- /get-started/part5/
-- /get-started/part6/
-- /getstarted/
-- /getting-started/
-- /learn/
-- /linux/last_page/
-- /linux/started/
-- /linux/step_four/
-- /linux/step_one/
-- /linux/step_six/
-- /linux/step_three/
-- /linux/step_two/
-- /mac/last_page/
-- /mac/started/
-- /mac/step_four/
-- /mac/step_one/
-- /mac/step_six/
-- /mac/step_three/
-- /mac/step_two/
-- /userguide/dockerimages/
-- /userguide/dockerrepos/
-- /windows/last_page/
-- /windows/started/
-- /windows/step_four/
-- /windows/step_one/
-- /windows/step_six/
-- /windows/step_three/
-- /windows/step_two/
 - /guides/get-started/
 - /get-started/hands-on-overview/
+- /guides/workshop/
 ---
 
 This 45-minute workshop contains step-by-step instructions on how to get started with Docker. This workshop shows you how to:
@@ -72,7 +21,7 @@ This 45-minute workshop contains step-by-step instructions on how to get started
 > [!NOTE]
 >
 > For a quick introduction to Docker and the benefits of containerizing your
-> applications, see [Getting started](../getting-started/_index.md).
+> applications, see [Getting started](/get-started/introduction/_index.md).
 
 ## What is a container?