Merge pull request #19665 from dvdksn/taxo

hugo: add tags

Dockerfile

@@ -13,7 +13,7 @@ ENV NODE_ENV=production
 RUN npm install
 
 FROM base AS hugo
-ARG HUGO_VERSION=0.122.0
+ARG HUGO_VERSION=0.124.1
 ARG TARGETARCH
 WORKDIR /tmp/hugo
 RUN wget -O "hugo.tar.gz" "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-${TARGETARCH}.tar.gz"

assets/css/toc.css

@@ -1,12 +1,6 @@
 @layer components {
   #TableOfContents {
-    nav {
+    .toc a {
-      @apply border-l-2 border-divider-light;
-    }
-    ul ul {
-      @apply pl-2;
-    }
-    a {
       @apply block max-w-full truncate py-1 pl-2 hover:font-medium hover:no-underline;
       &[aria-current="true"],
       &:hover {

content/admin/faqs/company-faqs.md

@@ -2,8 +2,10 @@
 description: Company FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, company, administration, company management
 title: FAQs on companies
+tags: [FAQ]
 aliases:
 - /docker-hub/company-faqs/
+- /faq/admin/company-faqs/
 ---
 
 ### Are existing subscriptions affected when you create a company and add organizations to it?
@@ -61,4 +63,4 @@ See [SCIM](scim.md) and [Group mapping](../../security/for-admins/group-mapping.
 
 ### What's the definition of a company vs an organization?
 
-A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together.
+A company is a collection of organizations that are managed together. An organization is a collection of repositories and teams that are managed together.

content/admin/faqs/general-faqs.md

@@ -2,9 +2,11 @@
 title: General FAQs for Docker accounts
 description: Frequently asked Docker account and administration questions
 keywords: onboarding, docker, teams, orgs, user accounts, organization accounts
+tags: [FAQ]
 aliases:
 - /docker-hub/general-faqs/
 - /docker-hub/onboarding-faqs/
+- /faq/admin/general-faqs/
 ---
 
 ### What is a Docker ID?
@@ -58,7 +60,7 @@ The organization owner can also add additional owners to help them manage users,
 ### Can I configure multiple SSO identity providers (IdPs) to authenticate users to a single org?
 
 Docker SSO allows only one IdP configuration per organization. For more
-information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../security/single-sign-on/faqs.md).
+information, see [Configure SSO](../../security/for-admins/single-sign-on/configure/_index.md) and [SSO FAQs](../../security/faqs/single-sign-on/faqs.md).
 
 ### What is a service account?
 
@@ -68,4 +70,4 @@ A [service account](../../docker-hub/service-accounts.md) is a Docker ID used fo
 
 Only someone with access to the Docker account can deactivate the account. For more details, see [Deactivating an account](../../admin/deactivate-account.md).
 
-If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team).
+If the user is a member of your organization, you can remove the user from your organization. For more details, see [Remove a member or invitee](../../admin/organization/members.md#remove-a-member-from-a-team).

content/admin/faqs/organization-faqs.md

@@ -2,8 +2,10 @@
 description: Organization FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, organizations, administration
 title: FAQs on organizations
+tags: [FAQ]
 aliases:
 - /docker-hub/organization-faqs/
+- /faq/admin/organization-faqs/
 ---
 
 ### What if the Docker ID I want for my organization or company is taken?
@@ -88,4 +90,4 @@ organization. See [Configure repository permissions for a team](manage-a-team.md
 
 ### Does my organization need to use Docker's registry?
 
-A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command.
+A registry is a hosted service containing repositories of images that responds to the Registry API. Docker Hub is Docker's primary registry, but you can use Docker with other container image registries. You can access the default registry by browsing to [Docker Hub](https://hub.docker.com) or using the `docker search` command.

content/billing/faqs.md

@@ -2,6 +2,7 @@
 title: Billing FAQs
 description: Frequently asked questions related to billing
 keywords: billing, renewal, payments, faq
+tags: [FAQ]
 ---
 
 For more information on billing, see [Billing and payments](_index.md).

content/build/architecture.md

@@ -90,4 +90,4 @@ For more information about BuildKit, see [BuildKit](buildkit/index.md).
 The following diagram shows an example build sequence involving Buildx and
 BuildKit.
 
-![Buildx and BuildKit sequence diagram](./images/build-execution.png)
+![Buildx and BuildKit sequence diagram](./images/build-execution.png)

content/build/building/secrets.md

@@ -2,6 +2,7 @@
 title: Build secrets
 description: Manage credentials and other secrets securely
 keywords: build, secrets, credentials, passwords, tokens, ssh, git, auth, http
+tags: [Secrets]
 ---
 
 A build secret is any piece of sensitive information, such as a password or API

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

@@ -2,6 +2,7 @@
 title: Using secrets with GitHub Actions
 description: Example using secret mounts with GitHub Actions
 keywords: ci, github actions, gha, buildkit, buildx, secret
+tags: [Secrets]
 ---
 
 A build secret is sensitive information, such as a password or API token, consumed as part of the build process.

content/build/dockerfile/release-notes.md

@@ -2,6 +2,7 @@
 title: Dockerfile release notes
 description: Release notes for Dockerfile frontend
 keywords: build, dockerfile, frontend, release notes
+tags: [Release notes]
 toc_max: 2
 ---
 

content/build/release-notes.md

@@ -2,6 +2,7 @@
 title: Build release notes
 description: Release notes for Buildx
 keywords: build, buildx, buildkit, release notes
+tags: [Release notes]
 toc_max: 2
 ---
 

content/compose/environment-variables/best-practices.md

@@ -3,6 +3,7 @@ title: Best practices for working with environment variables in Docker Compose
 description: Explainer on the best ways to set, use, and manage environment variables in
   Compose
 keywords: compose, orchestration, environment, env file, environment variables
+tags: [Best practices]
 ---
 
 #### Handle sensitive information securely

content/compose/faq.md

@@ -2,6 +2,7 @@
 description: Frequently asked questions for Docker Compose
 keywords: documentation, docs,  docker, compose, faq, docker compose vs docker-compose
 title: Compose FAQs
+tags: [FAQ]
 ---
 
 {{< include "compose-eol.md" >}}
@@ -105,4 +106,4 @@ supports hot code reloading or live-reload.
 There may be cases where you want to use both. You can have the image
 include the code using a `COPY`, and use a `volume` in your Compose file to
 include the code from the host during development. The volume overrides
-the directory contents of the image.
+the directory contents of the image.

content/compose/install/_index.md

@@ -48,4 +48,4 @@ You can [install the Compose standalone](standalone.md) on Linux or on Windows S
 > **Warning**
 >
 >This install scenario is not recommended and is only supported for backward compatibility purposes.
-{ .warning }
+{ .warning }

content/compose/release-notes.md

@@ -2,6 +2,7 @@
 title: Docker Compose release notes
 description: Release notes for Docker Compose
 keywords: release notes, compose
+tags: [Release notes]
 toc_max: 2
 aliases:
 - /release-notes/docker-compose/

content/compose/samples-for-compose.md

@@ -39,4 +39,4 @@ These samples focus specifically on Docker Compose:
 
 ## Awesome Compose samples
 
-The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`.
+The Awesome Compose samples provide a starting point on how to integrate different frameworks and technologies using Docker Compose. All samples are available in the [Awesome-compose GitHub repo](https://github.com/docker/awesome-compose) and are ready to run with `docker compose up`.

content/compose/use-secrets.md

@@ -2,6 +2,7 @@
 title: How to use secrets in Docker Compose
 description: How to use secrets in Compose and their benefits
 keywords: secrets, compose, security, environment variables
+tags: [Secrets]
 ---
 
 A secret is any piece of data, such as a password, certificate, or API key, that shouldn’t be transmitted over a network or stored unencrypted in a Dockerfile or in your application’s source code.

content/config/daemon/troubleshoot.md

@@ -2,6 +2,7 @@
 title: Troubleshooting the Docker daemon
 description: Learn how to troubleshoot errors and misconfigurations in the Docker daemon
 keywords: docker, daemon, configuration, troubleshooting, error, fail to start
+tags: [ Troubleshooting ]
 ---
 
 This page describes how to troubleshoot and debug the daemon if you run into

content/contribute/components/call-outs.md

@@ -16,7 +16,7 @@ We support these broad categories of callouts:
 
 ## Examples
 
-{{< introduced buildx 0.10.4 "../../release-notes.md#0104" >}}
+{{< introduced buildx 0.10.4 >}}
 
 > **Note**
 >
@@ -114,4 +114,4 @@ For both of the following callouts, consult [the Docker release lifecycle](/rele
 > Docker Scout is an [early access](/release-lifecycle/#early-access-ea)
 > product.
 { .restricted }
-```
+```

content/desktop/_index.md

@@ -6,37 +6,33 @@ keywords: how to use docker desktop, what is docker desktop used for, what does
 title: Overview of Docker Desktop
 grid:
 - title: Install Docker Desktop
-  description: 'Install Docker Desktop on
+  description: |
-
+    Install Docker Desktop on
     [Mac](/desktop/install/mac-install/),
-
     [Windows](/desktop/install/windows-install/), or
-
     [Linux](/desktop/install/linux-install/).
-
-    '
   icon: download
 - title: Explore Docker Desktop
   description: Navigate Docker Desktop and learn about its key features.
   icon: feature_search
-  link: /desktop/use-desktop
+  link: /desktop/use-desktop/
 - title: View the release notes
   description: Find out about new features, improvements, and bug fixes.
   icon: note_add
-  link: /desktop/release-notes
+  link: /desktop/release-notes/
 - title: Browse common FAQs
   description: Explore general FAQs or FAQs for specific platforms.
   icon: help
   link: /desktop/faqs/
 - title: Find additional resources
-  description: Find information on networking features, deploying on Kubernetes, and
+  description: |
-    more.
+    Find information on networking features, deploying on Kubernetes, and more.
   icon: category
-  link: /desktop/kubernetes
+  link: /desktop/kubernetes/
 - title: Give feedback
   description: Provide feedback on Docker Desktop or Docker Desktop features.
   icon: sms
-  link: /desktop/feedback
+  link: /desktop/feedback/
 aliases:
 - /desktop/opensource/
 - /docker-for-mac/dashboard/
@@ -52,17 +48,16 @@ It provides a straightforward GUI (Graphical User Interface) that lets you manag
 
 Docker Desktop reduces the time spent on complex setups so you can focus on writing code. It takes care of port mappings, file system concerns, and other default settings, and is regularly updated with bug fixes and security updates.
 
-
 {{< tabs >}}
 {{< tab name="What's included in Docker Desktop?" >}}
 
-- [Docker Engine](../engine/index.md)
+- [Docker Engine](../engine/_index.md)
 - Docker CLI client
 - [Docker Scout](../scout/_index.md) (additional subscription may apply)
-- [Docker Build](../build/index.md)
+- [Docker Build](../build/_index.md)
-- [Docker Extensions](extensions/index.md)
+- [Docker Extensions](./extensions/_index.md)
-- [Docker Compose](../compose/index.md)
+- [Docker Compose](../compose/_index.md)
-- [Docker Content Trust](../engine/security/trust/index.md)
+- [Docker Content Trust](../engine/security/trust/_index.md)
 - [Kubernetes](https://github.com/kubernetes/kubernetes/)
 - [Credential Helper](https://github.com/docker/docker-credential-helpers/)
 

content/desktop/extensions-sdk/design/mui-best-practices.md

@@ -47,4 +47,4 @@ Some of the above options require you to extend our MUI theme. See the MUI docum
 ## What's next?
 
 - Take a look at our [UI styling guide](index.md).
-- Learn how to [publish your extension](../extensions/index.md).
+- Learn how to [publish your extension](../extensions/index.md).

content/desktop/extensions-sdk/quickstart.md

@@ -90,4 +90,4 @@ $ docker extension rm <name-of-your-extension>
 - Learn how to [test and debug](dev/test-debug.md) your extension.
 - Learn how to [setup CI for your extension](dev/continuous-integration.md).
 - Learn more about extensions [architecture](architecture/index.md).
-- Learn more about [designing the UI](design/design-guidelines.md).
+- Learn more about [designing the UI](design/design-guidelines.md).

content/desktop/faqs/general.md

@@ -2,6 +2,7 @@
 description: Frequently asked Docker Desktop questions for all platforms
 keywords: desktop, mac, windows, faqs
 title: General FAQs for Desktop
+tags: [FAQ]
 aliases:
 - /mackit/faqs/
 - /docker-for-mac/faqs/

content/desktop/faqs/linuxfaqs.md

@@ -2,6 +2,7 @@
 description: Frequently asked questions for Docker Desktop for Linux
 keywords: desktop, linux, faqs
 title: FAQs for Docker Desktop for Linux
+tags: [FAQ]
 aliases:
 - /desktop/linux/space/
 ---

content/desktop/faqs/macfaqs.md

@@ -2,6 +2,7 @@
 description: Frequently asked questions for Docker Desktop for Mac
 keywords: desktop, mac, faqs
 title: FAQs for Docker Desktop for Mac
+tags: [FAQ]
 aliases:
 - /desktop/mac/space/
 - /docker-for-mac/space/

content/desktop/faqs/releases.md

@@ -2,6 +2,7 @@
 description: Frequently asked Docker Desktop questions for all platforms
 keywords: desktop, mac, windows, faqs
 title: FAQs on Docker Desktop releases
+tags: [FAQ]
 ---
 
 ### How frequent will new releases be?

content/desktop/faqs/windowsfaqs.md

@@ -2,6 +2,7 @@
 description: Frequently asked questions for Docker Desktop for Windows
 keywords: desktop, windows, faqs
 title: FAQs for Docker Desktop for Windows
+tags: [FAQ]
 ---
 
 ### Can I use VirtualBox alongside Docker Desktop?

content/desktop/hardened-desktop/enhanced-container-isolation/_index.md

@@ -59,7 +59,7 @@ For more information on how Enhanced Container Isolation work, see [How does it
 >
 > Enhanced Container Isolation does not yet fully protect Docker builds,
 > Kubernetes pods and Extension containers. For more information on known
-> limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md).
+> limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md).
 {.important }
 
 ### What host OSes / platforms is Enhanced Container Isolation supported on?
@@ -87,7 +87,7 @@ To enable Enhanced Container Isolation as a developer:
 
 > **Important**
 >
-> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../faq/security/eci-faq.md).
+> Enhanced Container Isolation does not protect containers created prior to enabling ECI. For more information on known limitations and workarounds, see [FAQs](../../../security/faqs/eci-faq.md).
 { .important }
 
 #### As an admin

content/desktop/hardened-desktop/enhanced-container-isolation/how-eci-works.md

@@ -16,7 +16,7 @@ When [Enhanced Container Isolation is enabled](index.md#how-do-i-enable-enhanced
 created by users through `docker run` or `docker create` are automatically
 launched using Sysbox instead of the standard OCI runc runtime. Users need not
 do anything else and can continue to use containers as usual. For exceptions,
-see [FAQs](../../../faq/security/eci-faq.md).
+see [FAQs](../../../security/faqs/eci-faq.md).
 
 Even containers that use the insecure `--privileged` flag can now be run
 securely with Enhanced Container Isolation, such that they can no longer be used

content/desktop/install/archlinux.md

@@ -53,4 +53,4 @@ $ sudo pacman -S gnome-terminal
 
 - Take a look at the [Get started](../../get-started/index.md) training modules 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.
-- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.
+- Review the topics in [Develop with Docker](../../develop/index.md) to learn how to build new applications using Docker.

content/desktop/release-notes.md

@@ -2,6 +2,7 @@
 description: Release notes for Docker Desktop for Mac, Linux, and Windows
 keywords: Docker desktop, release notes, linux, mac, windows
 title: Docker Desktop release notes
+tags: [Release notes]
 toc_max: 2
 aliases:
 - /docker-for-mac/release-notes/

content/desktop/troubleshoot/known-issues.md

@@ -2,6 +2,7 @@
 description: Find known issues for Docker Desktop
 keywords: mac, troubleshooting, known issues, Docker Desktop
 title: Known issues
+tags: [ Troubleshooting ]
 ---
 
 {{< tabs >}}
@@ -72,4 +73,4 @@ title: Known issues
 - `ping` from inside a container to the Internet does not work as expected.  To test the network, use `curl` or `wget`. See [docker/for-mac#5322](https://github.com/docker/for-mac/issues/5322#issuecomment-809392861).
 - Users may occasionally experience data drop when a TCP stream is half-closed.
 {{< /tab >}}
-{{< /tabs >}}
+{{< /tabs >}}

content/desktop/troubleshoot/overview.md

@@ -13,6 +13,7 @@ aliases:
 - /windows/troubleshoot/
 - /docker-for-win/troubleshoot/
 - /docker-for-windows/troubleshoot/
+tags: [ Troubleshooting ]
 ---
 
 This page contains information on how to diagnose and troubleshoot Docker Desktop, and how to check the logs.
@@ -312,4 +313,4 @@ to learn how to view the Docker Daemon logs.
 
 - View specific [troubleshoot topics](topics.md).
 - Implement [workarounds for common problems](workarounds.md)
-- View information on [known issues](known-issues.md)
+- View information on [known issues](known-issues.md)

content/desktop/troubleshoot/topics.md

@@ -3,6 +3,7 @@ description: Explore common troubleshooting topics for Docker Desktop
 keywords: Linux, Mac, Windows, troubleshooting, topics, Docker Desktop
 title: Troubleshoot topics for Docker Desktop
 toc_max: 4
+tags: [ Troubleshooting ]
 ---
 
 > **Tip**

content/desktop/troubleshoot/workarounds.md

@@ -2,6 +2,7 @@
 description: Common workarounds
 keywords: linux, mac, windows, troubleshooting, workarounds, Docker Desktop
 title: Workarounds for common problems
+tags: [ Troubleshooting ]
 ---
 
 ### Reboot
@@ -44,4 +45,4 @@ typically occurs after a Windows update and
 manifests as an error response from the Docker daemon and a Docker Desktop start failure.
 
 For a temporary workaround, uninstall the anti-virus software, or
-explore other workarounds suggested on Docker Desktop forums.
+explore other workarounds suggested on Docker Desktop forums.

content/desktop/wsl/best-practices.md

@@ -2,6 +2,7 @@
 title: Best practices
 description: Best practices for using Docker Desktop with WSL 2
 keywords: wsl, docker desktop, best practices
+tags: [Best practices]
 ---
 
 - Always use the latest version of WSL. At a minimum you must use WSL version 1.1.3.0., otherwise Docker Desktop may not work as expected. Testing, development, and documentation is based on the newest kernel versions. Older versions of WSL can cause:
@@ -17,4 +18,4 @@ keywords: wsl, docker desktop, best practices
     - Instead, from a Linux shell use a command like `docker run -v ~/my-project:/sources <my-image>` where `~` is expanded by the Linux shell to `$HOME`.
 
 - If you have concerns about the size of the docker-desktop-data VHDX, or need to change it, take a look at the [WSL tooling built into Windows](https://learn.microsoft.com/en-us/windows/wsl/disk-space).
-- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig).
+- If you have concerns about CPU or memory usage, you can configure limits on the memory, CPU, and swap size allocated to the [WSL 2 utility VM](https://learn.microsoft.com/en-us/windows/wsl/wsl-config#global-configuration-options-with-wslconfig).

content/develop/dev-best-practices.md

@@ -2,6 +2,7 @@
 title: Docker development best practices
 description: Rules of thumb for making your life easier as a Docker application developer
 keywords: application, development
+tags: [Best practices]
 ---
 
 The following development patterns have proven to be helpful for people

content/develop/develop-images/dockerfile_best-practices.md

@@ -8,6 +8,7 @@ aliases:
 - /docker-cloud/getting-started/intermediate/optimize-dockerfiles/
 - /docker-cloud/tutorials/optimize-dockerfiles/
 - /engine/userguide/eng-image/dockerfile_best-practices/
+tags: [Best practices]
 ---
 
 This topic covers recommended best practices and methods for building

content/develop/develop-images/guidelines.md

@@ -2,6 +2,7 @@
 description: Hints, tips and guidelines for writing clean, reliable Dockerfiles
 keywords: parent image, images, dockerfile, best practices, hub, official image
 title: General best practices for writing Dockerfiles
+tags: [Best practices]
 ---
 
 ## Use multi-stage builds

content/develop/security-best-practices.md

@@ -4,6 +4,7 @@ description: Image security best practices guide
 keywords: docker, images, containers, vulnerability, cve
 aliases:
 - /develop/scan-images/
+tags: [Best practices]
 ---
 
 You can take a few steps to improve the security of your

content/docker-hub/builds/troubleshoot.md

@@ -2,6 +2,7 @@
 title: Troubleshoot your autobuilds
 description: How to troubleshoot Automated builds
 keywords: docker hub, troubleshoot, automated builds, autobuilds
+tags: [ Troubleshooting ]
 ---
 
 > **Note**
@@ -66,4 +67,4 @@ system access to the repositories.
 > **Note**
 >
 > You must configure your private git submodules using git clone over SSH
-> (`git@submodule.tld:some-submodule.git`) rather than HTTPS.
+> (`git@submodule.tld:some-submodule.git`) rather than HTTPS.

content/docker-hub/quickstart.md

@@ -216,4 +216,4 @@ You've successfully:
 - Automatically build container images from code through [builds](builds/index.md).
 - [Explore](https://hub.docker.com/explore) official & publisher images.
 - [Upgrade your subscription](https://www.docker.com/pricing) to push additional private Docker images to
-Docker Hub.
+Docker Hub.

content/docker-hub/release-notes.md

@@ -5,6 +5,7 @@ description: Learn about the new features, bug fixes, and breaking changes for D
 keywords: docker hub, whats new, release notes
 toc_min: 1
 toc_max: 2
+tags: [Release notes]
 ---
 
 Here you can learn about the latest changes, new features, bug fixes, and

content/engine/install/linux-postinstall.md

@@ -142,4 +142,4 @@ options:
 - Read the [Get started](../../get-started/index.md) training modules
   to learn how to build an image and run it as a containerized application.
 - Review the topics in [Develop with Docker](../../develop/index.md) to learn
-  how to build new applications using Docker.
+  how to build new applications using Docker.

content/engine/install/troubleshoot.md

@@ -2,6 +2,7 @@
 title: Troubleshoot Docker Engine installation
 description: Learn how to diagnose and resolve error messages related to the Docker Engine installation.
 keywords: Docker Engine, troubleshooting, error, Linux, install Docker Engine
+tags: [ Troubleshooting ]
 ---
 
 This page contains instructions for troubleshooting and diagnosing the Docker
@@ -288,4 +289,4 @@ Docker isn't running.
    An error occurs if your GRUB configuration file has incorrect syntax. In this
    case, repeat steps 2 and 3.
 
-   The changes take effect when you reboot the system.
+   The changes take effect when you reboot the system.

content/engine/swarm/secrets.md

@@ -3,6 +3,7 @@ title: Manage sensitive data with Docker secrets
 description: How to securely store, retrieve, and use sensitive data with Docker services
 keywords: swarm, secrets, credentials, sensitive strings, sensitive data, security,
   encryption, encryption at rest
+tags: [Secrets]
 ---
 
 ## About secrets

content/faq/_index.md

@@ -1,28 +0,0 @@
----
-title: Frequently asked questions
-description: Landing page to common FAQ topics
-keywords: faqs, desktop, Hub, Scout, Engine, Build, Extensions
-grid:
-- title: Subscription
-  icon: contact_page
-  link: /subscription/faq/
-- title: Billing
-  icon: credit_score
-  link: /billing/faqs/
-- title: Docker account
-  icon: lan
-  link: /faq/admin/general-faqs/
-- title: Enforcing Single Sign-On
-  icon: key
-  link: /single-sign-on/enforcement-faqs/
-- title: Single Sign-On and IdPs
-  icon: checklist
-  link: /single-sign-on/idp-faqs/
-- title: Docker Desktop
-  icon: explore
-  link: /desktop/faqs/general/
----
-
-Explore popular FAQ topics.
-
-{{< grid >}}

content/release-notes.md

@@ -1,34 +0,0 @@
----
-description: Release notes for Docker
-keywords: docker, documentation, about, technology, understanding,  release, scout, desktop, hub, compose, build, engine
-title: Release notes for Docker
-grid:
-- title: Docker Desktop
-  icon: web_asset
-  link: /desktop/release-notes/
-- title: Docker Engine
-  icon: developer_board
-  link: /engine/release-notes/
-- title: Docker Compose
-  icon: storage
-  link: /compose/release-notes/
-- title: Docker Build
-  icon: construction
-  link: /build/release-notes/
-- title: Docker Hub
-  icon: widgets
-  link: /docker-hub/release-notes/
-- title: Docker Scout (platform)
-  icon: query_stats
-  link: /scout/release-notes/platform/
-- title: Docker Scout (CLI)
-  icon: query_stats
-  link: /scout/release-notes/cli/
----
-
-Find out what's new in Docker. Release notes contain information about new
-features, improvements, known issues, and bug fixes in each release. You can
-find release notes for each component in the Manuals section. We suggest
-that you regularly visit the release notes to learn about updates.
-
-{{< grid >}}

content/scout/release-notes/platform.md

@@ -4,6 +4,7 @@ description: Learn about the latest features of Docker Scout
 keywords: docker scout, release notes, changelog, features, changes, delta, new, releases
 aliases:
 - /scout/release-notes/
+tags: [Release notes]
 ---
 
 This page contains information about the new features, improvements, known

content/security/faqs/eci-faq.md

@@ -3,8 +3,10 @@ title: Enhanced Container Isolation (ECI) FAQs
 description: Frequently asked questions for Enhanced Container Isolation
 keywords: enhanced container isolation, security, faq, sysbox, Docker Desktop
 toc_max: 2
+tags: [FAQ]
 aliases:
 - /desktop/hardened-desktop/enhanced-container-isolation/faq/
+- /faq/security/eci-faq/
 ---
 
 ### Do I need to change the way I use Docker when ECI is switched on?

content/security/faqs/general.md

@@ -2,6 +2,9 @@
 description: Find the answers to common security related FAQs
 keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, Docker Scout, admin, security
 title: General security FAQs
+tags: [FAQ]
+aliases:
+- /faq/security/general/
 ---
 
 ### How do I report a vulnerability?

content/security/faqs/networking-and-vms.md

@@ -2,6 +2,9 @@
 description: Find the answers to FAQs related to networking and virtualization
 keywords: Docker, Docker Hub, Docker Desktop secuirty FAQs, secuirty, platform, networks, vms
 title: Network and VM FAQs
+tags: [FAQ]
+aliases:
+- /faq/security/networking-and-vms/
 ---
 
 ### How can I limit the type of internet access allowed by the container when it runs, to prevent it from being able to exfiltrate data or download malicious code? 
@@ -30,4 +33,4 @@ On Mac it is an unprivileged operation to start a VM, so that is not enforced by
 
 ### How does Docker Desktop achieve network level isolation when Hyper-V and/or WSL2 is used? 
 
-The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/). 
+The VM processes are the same for both WSL 2 (running inside the `docker-desktop` distro) and Hyper-V (running inside the `DockerDesktopVM`). Host/VM communication uses `AF_VSOCK` hypervisor sockets (shared memory). It does not use Hyper-V network switches or network interfaces. All host networking is performed using normal TCP/IP sockets from the `com.docker.vpnkit.exe` and `com.docker.backend.exe` processes. For more information see [How Docker Desktop networking works under the hood](https://www.docker.com/blog/how-docker-desktop-networking-works-under-the-hood/). 

content/security/faqs/single-sign-on/domain-faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on domain FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, domains, domain verification
 title: Domains
+tags: [FAQ]
 aliases:
 - /single-sign-on/domain-faqs/
+- /faq/security/single-sign-on/domain-faqs/
 ---
 
 ### Can I add sub-domains?
@@ -28,4 +30,4 @@ Runtime for Docker Desktop if they configure Docker Desktop to require authentic
 
 ### Do you support IdP-initiated authentication (e.g., Okta tile support)?
 
-We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub.
+We don't support IdP-initiated authentication. Users must initiate login through Docker Desktop or Hub.

content/security/faqs/single-sign-on/enforcement-faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on enforcement FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, enforce SSO, SSO enforcement
 title: Enforcement
+tags: [FAQ]
 aliases:
 - /single-sign-on/enforcement-faqs/
+- /faq/security/single-sign-on/enforcement-faqs/
 ---
 
 ### We currently have a Docker Team subscription. How do we enable SSO?

content/security/faqs/single-sign-on/faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, administration, security
 title: General FAQs on SSO
+tags: [FAQ]
 aliases:
 - /single-sign-on/faqs/
+- /faq/security/single-sign-on/faqs/
 ---
 
 ### Is Docker SSO available for all paid subscriptions?
@@ -32,4 +34,4 @@ Yes, all users in your organization must upgrade to Docker Desktop version 4.4.2
 
 ### Can I retain my Docker ID when using SSO?
 
-For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created.
+For a personal Docker ID, a user is the account owner. A Docker ID is associated with access to the user's repositories, images, assets. An end user can choose to have a company domain email on the Docker account. When enforcing SSO, the account is connected to the organization account. When enforcing SSO for an organization(s) or company, any user logging in without an existing account using verified company domain email will automatically have an account provisioned, and a new Docker ID created.

content/security/faqs/single-sign-on/idp-faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on IdP FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, IdP
 title: Identity providers
+tags: [FAQ]
 aliases:
 - /single-sign-on/idp-faqs/
+- /faq/security/single-sign-on/idp-faqs/
 ---
 
 ### Is it possible to use more than one IdP with Docker SSO?

content/security/faqs/single-sign-on/saml-faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on SAML FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on, SAML
 title: SAML
+tags: [FAQ]
 aliases:
 - /single-sign-on/saml-faqs/
+- /faq/security/single-sign-on/saml-faqs/
 ---
 
 ### Does SAML authentication require additional attributes?
@@ -20,4 +22,4 @@ At runtime for Docker Desktop if it’s configured to require authentication to
 
 ### Do you have any information on how to use the Docker Desktop application in accordance with the SSO users we provide? How can we verify that we're handling the licensing correctly?
 
-Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future.
+Verify that your users have downloaded the latest version of Docker Desktop. An enhancement in user management observability and capabilities will become available in the future.

content/security/faqs/single-sign-on/users-faqs.md

@@ -2,8 +2,10 @@
 description: Single Sign-on user management FAQs
 keywords: Docker, Docker Hub, SSO FAQs, single sign-on
 title: Manage users
+tags: [FAQ]
 aliases:
 - /single-sign-on/users-faqs/
+- /faq/security/single-sign-on/users-faqs/
 ---
 
 ### How do I manage users when using SSO?

content/security/for-admins/single-sign-on/_index.md

@@ -37,4 +37,4 @@ In addition, you should add all email addresses to your IdP.
 ## What's next?
 
 - Start [configuring SSO](configure/_index.md) in Docker
-- Explore the [FAQs](../../../faq/security/single-sign-on/faqs.md)
+- Explore the [FAQs](../../../security/faqs/single-sign-on/faqs.md)

content/storage/troubleshooting_volume_errors.md

@@ -4,6 +4,7 @@ keywords: cadvisor, troubleshooting, volumes, bind-mounts
 title: Troubleshoot storage errors
 aliases:
 - /engine/admin/troubleshooting_volume_errors/
+tags: [ Troubleshooting ]
 ---
 
 This topic discusses errors which may occur when you use Docker volumes or bind
@@ -58,4 +59,4 @@ $ sudo lsof /var/lib/docker/containers/74bef250361c7817bee19349c93139621b272bc8f
 ```
 
 To work around this problem, stop the container which bind-mounts
-`/var/lib/docker` and try again to remove the other container.
+`/var/lib/docker` and try again to remove the other container.

content/subscription/faq.md

@@ -2,6 +2,7 @@
 description: FAQs on Docker subscriptions
 keywords: Docker, Docker Hub, subscription FAQs, subscription, platform
 title: Subscription FAQs
+tags: [FAQ]
 ---
 
 For more information on Docker subscriptions, see [Docker subscription overview](_index.md).

content/support.md

@@ -98,10 +98,4 @@ For more information, see [Docker Data Processing Agreement](https://www.docker.
 
 Before seeking support, you can perform basic troubleshooting. See [Diagnose and troubleshooting](../desktop/troubleshoot/overview.md) for more information.
 
-You can also see if an answer already exists in the following FAQs:
+You can also see if an answer already exists in the [FAQs](/tags/faq/).
-- [Docker Business or Team onboarding](faq/admin/general-faqs.md)
-- [Docker Desktop](../desktop/faqs/general.md)
-- [Docker Desktop for Linux](../desktop/faqs/linuxfaqs.md)
-- [Docker Desktop for Mac](../desktop/faqs/macfaqs.md)
-- [Docker Desktop for Windows](../desktop/faqs/windowsfaqs.md)
-- [Single Sign-on](faq/security/single-sign-on/faqs.md)

content/tags/_index.md

@@ -0,0 +1,5 @@
+---
+title: Tags
+---
+
+Here you can browse Docker docs by tag.

content/tags/best-practices/_index.md

@@ -0,0 +1,8 @@
+---
+title: Best practices
+icon: star
+description: Optimal patterns for Docker
+---
+
+Best practices articles describe methods and techniques that are generally
+the most idiomatic and optimized way to do something.

content/tags/faq/_index.md

@@ -0,0 +1,9 @@
+---
+title: FAQ
+icon: quiz
+description: Frequently asked questions
+---
+
+FAQs contain frequently asked questions about all things Docker, from accounts
+and administration to organization management, Docker Desktop, Docker Compose,
+and more.

content/tags/release-notes/_index.md

@@ -0,0 +1,10 @@
+---
+title: Release notes
+icon: note_stack_add
+description: Find out about the latest features
+aliases:
+- /release-notes/
+---
+
+Release notes describe corrections, changes or enhancements made to a product
+product in a given release.

content/tags/secrets/_index.md

@@ -0,0 +1,11 @@
+---
+title: Secrets
+icon: password
+description: Use sensitive information in containers securely
+---
+
+A secret is a piece of data, such as a password, SSH private key, SSL
+certificate, or anything that should not be transmitted over a network or
+stored unencrypted in a Dockerfile or in your application's source code.
+
+Docker provides specially designated features for managing secrets.

content/tags/troubleshooting/_index.md

@@ -0,0 +1,8 @@
+---
+title: Troubleshooting
+icon: troubleshoot
+description: Fix common issues
+---
+
+Troubleshooting articles contain guidelines for solving common problems and
+pitfalls that you might encounter with Docker products.

data/toc.yaml

@@ -1016,103 +1016,100 @@ Reference:
           title: Version 2
 - path: /glossary/
   title: Glossary
-
+- sectiontitle: Samples
-
-
-Samples:
-- path: /samples/
-  title: Overview
-- sectiontitle: Databases
   section:
-    - path: /samples/mariadb/
+  - path: /samples/
-      title: MariaDB
+    title: Overview
-    - path: /samples/mongodb/
+  - sectiontitle: Databases
-      title: MongoDB
+    section:
-    - path: /samples/ms-sql/
+      - path: /samples/mariadb/
-      title: MS-SQL
+        title: MariaDB
-    - path: /samples/mysql/
+      - path: /samples/mongodb/
-      title: MySQL
+        title: MongoDB
-    - path: /samples/postgres/
+      - path: /samples/ms-sql/
-      title: PostgreSQL
+        title: MS-SQL
-    - path: /samples/redis/
+      - path: /samples/mysql/
-      title: Redis
+        title: MySQL
-- sectiontitle: Frameworks
+      - path: /samples/postgres/
-  section:
+        title: PostgreSQL
-    - path: /samples/dotnet/
+      - path: /samples/redis/
-      title: .NET
+        title: Redis
-    - path: /samples/angular/
+  - sectiontitle: Frameworks
-      title: Angular
+    section:
-    - path: /samples/django/
+      - path: /samples/dotnet/
-      title: Django
+        title: .NET
-    - path: /samples/express/
+      - path: /samples/angular/
-      title: Express
+        title: Angular
-    - path: /samples/fastapi/
+      - path: /samples/django/
-      title: FastAPI
+        title: Django
-    - path: /samples/flask/
+      - path: /samples/express/
-      title: Flask
+        title: Express
-    - path: /samples/nodejs/
+      - path: /samples/fastapi/
-      title: Node.js
+        title: FastAPI
-    - path: /samples/react/
+      - path: /samples/flask/
-      title: React
+        title: Flask
-    - path: /samples/rails/
+      - path: /samples/nodejs/
-      title: Rails
+        title: Node.js
-    - path: /samples/spark/
+      - path: /samples/react/
-      title: Spark
+        title: React
-    - path: /samples/spring/
+      - path: /samples/rails/
-      title: Spring Boot
+        title: Rails
-    - path: /samples/vuejs/
+      - path: /samples/spark/
-      title: Vue.js
+        title: Spark
-- sectiontitle: Languages
+      - path: /samples/spring/
-  section:
+        title: Spring Boot
-    - path: /samples/go/
+      - path: /samples/vuejs/
-      title: Go
+        title: Vue.js
-    - path: /samples/java/
+  - sectiontitle: Languages
-      title: Java
+    section:
-    - path: /samples/javascript/
+      - path: /samples/go/
-      title: JavaScript
+        title: Go
-    - path: /samples/php/
+      - path: /samples/java/
-      title: PHP
+        title: Java
-    - path: /samples/python/
+      - path: /samples/javascript/
-      title: Python
+        title: JavaScript
-    - path: /samples/ruby/
+      - path: /samples/php/
-      title: Ruby
+        title: PHP
-    - path: /samples/rust/
+      - path: /samples/python/
-      title: Rust
+        title: Python
-    - path: /samples/typescript/
+      - path: /samples/ruby/
-      title: TypeScript
+        title: Ruby
-- sectiontitle: Platforms
+      - path: /samples/rust/
-  section:
+        title: Rust
-    - path: /samples/gitea/
+      - path: /samples/typescript/
-      title: Gitea
+        title: TypeScript
-    - path: /samples/nextcloud/
+  - sectiontitle: Platforms
-      title: Nextcloud
+    section:
-    - path: /samples/portainer/
+      - path: /samples/gitea/
-      title: Portainer
+        title: Gitea
-    - path: /samples/prometheus/
+      - path: /samples/nextcloud/
-      title: Prometheus
+        title: Nextcloud
-    - path: /samples/wordpress/
+      - path: /samples/portainer/
-      title: WordPress
+        title: Portainer
-- sectiontitle: Other samples
+      - path: /samples/prometheus/
-  section:
+        title: Prometheus
-    - path: /samples/ai-ml/
+      - path: /samples/wordpress/
-      title: AI/ML
+        title: WordPress
-    - path: /samples/cloudflared/
+  - sectiontitle: Other samples
-      title: Cloudflared
+    section:
-    - path: /samples/elasticsearch/
+      - path: /samples/ai-ml/
-      title: Elasticsearch / Logstash / Kibana
+        title: AI/ML
-    - path: /samples/minecraft/
+      - path: /samples/cloudflared/
-      title: Minecraft
+        title: Cloudflared
-    - path: /samples/nginx/
+      - path: /samples/elasticsearch/
-      title: NGINX
+        title: Elasticsearch / Logstash / Kibana
-    - path: /samples/pi-hole/
+      - path: /samples/minecraft/
-      title: Pi-hole
+        title: Minecraft
-    - path: /samples/plex/
+      - path: /samples/nginx/
-      title: Plex
+        title: NGINX
-    - path: /samples/traefik/
+      - path: /samples/pi-hole/
-      title: Traefik
+        title: Pi-hole
-    - path: /samples/wireguard/
+      - path: /samples/plex/
-      title: Wireguard
+        title: Plex
-
+      - path: /samples/traefik/
+        title: Traefik
+      - path: /samples/wireguard/
+        title: Wireguard
 
 Manuals:
 - path: /manuals/
@@ -1247,6 +1244,18 @@ Manuals:
       title: Uninstall Docker Desktop
     - path: /desktop/feedback/
       title: Give feedback
+    - sectiontitle: Desktop FAQs
+      section:
+      - path: /desktop/faqs/general/
+        title: General
+      - path: /desktop/faqs/macfaqs/
+        title: Mac
+      - path: /desktop/faqs/windowsfaqs/
+        title: Windows
+      - path: /desktop/faqs/linuxfaqs/
+        title: Linux
+      - path: /desktop/faqs/releases/
+        title: Releases
     - path: /desktop/release-notes/
       title: Release notes
     - sectiontitle: Previous versions
@@ -2050,6 +2059,8 @@ Manuals:
     title: Give feedback
   - path: /compose/migrate/
     title: Migrate to Compose V2
+  - path: /compose/faq/
+    title: Compose FAQ
   - path: /compose/release-notes/
     title: Release notes
 
@@ -2136,6 +2147,14 @@ Manuals:
       title: Manage users
     - path: /admin/company/owners/
       title: Manage company owners
+  - sectiontitle: Account and admin FAQ
+    section:
+    - path: /admin/faqs/general-faqs/
+      title: General
+    - path: /admin/faqs/organization-faqs/
+      title: Organization
+    - path: /admin/faqs/company-faqs/
+      title: Company
   - path: /admin/convert-account/
     title: Convert an account into an organization
   - path: /admin/deactivate-account/
@@ -2189,6 +2208,28 @@ Manuals:
         title: Generate a new recovery code
   - path: /security/security-announcements/
     title: Security announcements
+  - sectiontitle: Security FAQs
+    section:
+    - path: /security/faqs/general/
+      title: General
+    - path: /security/faqs/networking-and-vms/
+      title: Networking and VMs
+    - path: /security/faqs/eci-faq/
+      title: Enhanced Container Isolation
+    - sectiontitle: Single Sign-On
+      section:
+      - path: /security/faqs/single-sign-on/faqs/
+        title: General
+      - path: /security/faqs/single-sign-on/saml-faqs/
+        title: SAML
+      - path: /security/faqs/single-sign-on/idp-faqs/
+        title: Identity providers
+      - path: /security/faqs/single-sign-on/domain-faqs/
+        title: Domains
+      - path: /security/faqs/single-sign-on/enforcement-faqs/
+        title: Enforcement
+      - path: /security/faqs/single-sign-on/users-faqs/
+        title: Manage users
 
 - sectiontitle: Billing
   section:
@@ -2208,6 +2249,8 @@ Manuals:
     title: Docker Build Cloud billing
   - path: /billing/scout-billing/
     title: Docker Scout billing
+  - path: /billing/faqs/
+    title: Billing FAQs
 
 - sectiontitle: Subscription
   section:
@@ -2235,6 +2278,8 @@ Manuals:
     title: Docker Scout subscriptions and features
   - path: /subscription/desktop-license/
     title: Docker Desktop license agreement
+  - path: /subscription/faq/
+    title: Subscription FAQ
 
 - sectiontitle: Trusted content
   section:
@@ -2255,61 +2300,7 @@ Manuals:
   - path: /trusted-content/insights-analytics/
     title: Insights and analytics
 
-- path: /release-notes/
-  title: Release notes
 - path: /support/
   title: Get support
 - path: /release-lifecycle/
   title: Product release lifecycle
-
-FAQ:
-  - path: /faq/
-    title: Overview
-  - path: /billing/faqs/
-    title: Billing
-  - path: /compose/faq/
-    title: Compose
-  - sectiontitle: Desktop
-    section:
-    - path: /desktop/faqs/general/
-      title: General
-    - path: /desktop/faqs/macfaqs/
-      title: Mac
-    - path: /desktop/faqs/windowsfaqs/
-      title: Windows
-    - path: /desktop/faqs/linuxfaqs/
-      title: Linux
-    - path: /desktop/faqs/releases/
-      title: Releases
-  - sectiontitle: Docker account and admin
-    section:
-    - path: /faq/admin/general-faqs/
-      title: General
-    - path: /faq/admin/organization-faqs/
-      title: Organization
-    - path: /faq/admin/company-faqs/
-      title: Company
-  - path: /subscription/faq/
-    title: Subscription
-  - sectiontitle: Security
-    section:
-    - path: /faq/security/general/
-      title: General
-    - path: /faq/security/networking-and-vms/
-      title: Networking and VMs
-    - path: /faq/security/eci-faq/
-      title: Enhanced Container Isolation
-    - sectiontitle: Single Sign-On
-      section:
-      - path: /faq/security/single-sign-on/faqs/
-        title: General
-      - path: /faq/security/single-sign-on/saml-faqs/
-        title: SAML
-      - path: /faq/security/single-sign-on/idp-faqs/
-        title: Identity providers
-      - path: /faq/security/single-sign-on/domain-faqs/
-        title: Domains
-      - path: /faq/security/single-sign-on/enforcement-faqs/
-        title: Enforcement
-      - path: /faq/security/single-sign-on/users-faqs/
-        title: Manage users

hugo.yaml

@@ -4,9 +4,9 @@ refLinksErrorLevel: ERROR
 enableGitInfo: true
 disablePathToLower: true
 enableInlineShortcodes: true
-disableKinds:
+
-  - taxonomy
+taxonomies:
-  - term
+  tag: tags
 
 markup:
   tableOfContents:
@@ -126,12 +126,6 @@ menus:
   - name: Reference
     url: /reference/
     weight: 3
-  - name: Samples
-    url: /samples/
-    weight: 4
-  - name: FAQ
-    url: /faq/
-    weight: 5
 
   footer:
     - url: https://www.docker.com/products
@@ -236,7 +230,7 @@ module:
   proxy: https://proxy.golang.org,direct
   hugoVersion:
     extended: false
-    min: "0.116.1"
+    min: "0.124.1"
   mounts:
     - source: assets
       target: assets

hugo_stats.json

@@ -150,6 +150,7 @@
       "build-push-action",
       "chroma",
       "cls-1",
+      "cursor-not-allowed",
       "cursor-pointer",
       "dark:bg-accent-dark",
       "dark:bg-amber-dark",
@@ -159,6 +160,7 @@
       "dark:bg-blue-dark-400",
       "dark:bg-gray-dark-100",
       "dark:bg-gray-dark-200",
+      "dark:bg-gray-dark-300",
       "dark:bg-gray-dark-300/50",
       "dark:bg-gray-dark-400",
       "dark:bg-green-dark",
@@ -178,6 +180,7 @@
       "dark:hover:bg-blue-dark",
       "dark:hover:bg-blue-dark-500",
       "dark:hover:bg-gray-dark-500",
+      "dark:hover:text-white",
       "dark:prose-invert",
       "dark:syntax-dark",
       "dark:text-blue-dark",
@@ -186,6 +189,7 @@
       "dark:text-gray-dark-500",
       "dark:text-gray-dark-600",
       "dark:text-gray-dark-700",
+      "dark:text-gray-dark-800",
       "dark:text-violet-dark",
       "dark:text-white",
       "dark:to-blue-dark-100",
@@ -206,6 +210,7 @@
       "flex-col-reverse",
       "flex-initial",
       "flex-row-reverse",
+      "flex-wrap",
       "font-medium",
       "footnote-backref",
       "footnote-ref",
@@ -246,8 +251,10 @@
       "hover:drop-shadow-lg",
       "hover:opacity-75",
       "hover:opacity-90",
+      "hover:text-black",
       "hover:underline",
       "hub-api",
+      "icon-lg",
       "icon-sm",
       "icon-svg",
       "important",
@@ -264,10 +271,14 @@
       "justify-self-end",
       "leading-snug",
       "left-0",
+      "lg:block",
       "lg:grid-cols-2",
       "lg:grow-0",
       "lg:hidden",
+      "lg:link",
+      "lg:pb-0",
       "lg:px-4",
+      "lg:text-base",
       "lg:w-full",
       "link",
       "lntable",
@@ -300,8 +311,10 @@
       "ml-auto",
       "mt-1",
       "mt-20",
+      "mt-auto",
       "mx-auto",
       "my-0",
+      "my-2",
       "my-4",
       "no-underline",
       "no-wrap",
@@ -319,6 +332,7 @@
       "p-6",
       "p-8",
       "p-[2px]",
+      "pb-0.5",
       "pb-2",
       "pb-4",
       "pl-1",
@@ -331,6 +345,7 @@
       "pt-0",
       "px-1",
       "px-2",
+      "px-3",
       "px-4",
       "py-1",
       "py-2",
@@ -393,6 +408,7 @@
       "to-blue-light-500",
       "to-magenta-light-400",
       "to-transparent",
+      "toc",
       "top-0",
       "top-16",
       "top-3",

layouts/_default/list.html

@@ -8,6 +8,9 @@
     {{ with .Title }}
     <h1 class="scroll-mt-36">{{ . }}</h1>
     {{ end }}
+    <div class="hidden lg:block">
+      {{ partial "pagemeta.html" . }}
+    </div>
     {{ .Content }}
   </article>
 {{ end }}

layouts/_default/single.html

@@ -8,6 +8,10 @@
     {{ with .Title }}
     <h1 class="scroll-mt-36">{{ . }}</h1>
     {{ end }}
+    <div class="hidden lg:block">
+      {{ partial "pagemeta.html" . }}
+      <hr>
+    </div>
     {{ .Content }}
   </article>
 {{ end }}

layouts/index.html

@@ -190,6 +190,16 @@
           {{ end }}
         </div>
       </div>
+      <div class="flex flex-col gap-4">
+        <h2 class="mb-4 text-xl">Browse by tag</h2>
+        <div class="flex flex-wrap gap-4">
+          {{ $tags := slice }}
+          {{- range site.Taxonomies.tags }}
+            {{ $tags = $tags | append .Page }}
+          {{ end }}
+          {{ partial "tags.html" $tags }}
+        </div>
+      </div>
     </div>
 
     <div

layouts/partials/aside.html

@@ -1,4 +1,6 @@
 <aside class="py-4 space-y-4">
   {{ partial "github-links.html" . }}
-  {{ partial "toc-default.html" . }}
+  <div id="TableOfContents">
+    {{ partial "pagemeta.html" . }}
+  </div>
 </aside>

layouts/partials/pagemeta.html

@@ -0,0 +1,41 @@
+{{- $toc := false }}
+{{- with .Fragments }}
+  {{- $toc = and (ne page.Params.notoc true) .Headings }}
+{{- end }}
+{{- $tags := .GetTerms "tags" }}
+{{- if or $toc $tags }}
+  <div class="not-prose">
+  {{- with $tags }}
+    <div class="flex flex-col gap-2 my-2">
+      <span class="text-lg">Tags</span>
+      <div class="flex flex-wrap items-center gap-2">
+      {{- partial "tags.html" . -}}
+      </div>
+    </div>
+  {{- end }}
+  {{- with $toc }}
+    <div class="text-lg pb-2 lg:pb-0">Table of contents</div>
+    <nav class="toc">
+      {{ $root := (index page.Fragments.Headings 0).Headings }}
+      {{- template "walkHeadingFragments" $root }}
+    </nav>
+  {{- end }}
+  </div>
+{{- end }}
+
+{{- define "walkHeadingFragments" }}
+  {{- $min := 2 }}
+  {{- $max := 3 }}
+  <ul class="pl-2">
+    {{- range . }}
+      {{- if and (ge .Level $min) (le .Level $max) }}
+        <li>
+          <a class="lg:link" href="#{{ .ID }}">{{ .Title }}</a>
+        </li>
+      {{- end }}
+      {{- with .Headings }}
+        {{ template "walkHeadingFragments" . }}
+      {{- end }}
+    {{- end }}
+  </ul>
+{{- end }}

layouts/partials/pagination.html

@@ -0,0 +1,70 @@
+{{- if gt .Paginator.TotalPages 1 }}
+  {{ $selectable := "cursor-pointer" }}
+  {{ $active := "hover:text-black dark:hover:text-white underline underline-offset-8" }}
+  {{ $disabled := "cursor-not-allowed text-gray-light dark:text-gray-dark" }}
+  <ul class="flex gap-6 items-center">
+  {{- with .Paginator }}
+    {{- $currentPageNumber := .PageNumber }}
+
+    {{- with .First }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li>
+        <a class="{{ $selectable }}" href="{{ .URL }}" aria-label="First">
+          <span class="icon-svg">
+            {{- partialCached "icon" "navigate_before" "navigate_before" -}}
+          </span>
+        </a>
+      </li>
+      {{- else }}
+      <li>
+        <a class="{{ $disabled }}" aria-disabled="true" aria-label="First">
+          <span class="icon-svg">
+            {{- partialCached "icon" "navigate_before" "navigate_before" -}}
+          </span>
+        </a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- $slots := 5 }}
+    {{- $start := math.Max 1 (sub .PageNumber (math.Floor (div $slots 2))) }}
+    {{- $end := math.Min .TotalPages (sub (add $start $slots) 1) }}
+    {{- if lt (add (sub $end $start) 1) $slots }}
+      {{- $start = math.Max 1 (add (sub $end $slots) 1) }}
+    {{- end }}
+
+    {{- range $k := seq $start $end }}
+      {{- if eq $.Paginator.PageNumber $k }}
+      <li>
+        <a class="{{ $active }}" aria-current="page" aria-label="Page {{ $k }}">{{ $k }}</a>
+      </li>
+      {{- else }}
+      <li>
+        <a class="{{ $selectable }}" href="{{ (index $.Paginator.Pagers (sub $k 1)).URL }}" aria-label="Page {{ $k }}">{{ $k }}</a>
+      </li>
+      {{- end }}
+    {{- end }}
+
+    {{- with .Last }}
+      {{- if ne $currentPageNumber .PageNumber }}
+      <li>
+        <a class="{{ $selectable }}" href="{{ .URL }}" aria-label="Last">
+          <span class="icon-svg">
+            {{- partialCached "icon" "navigate_next" "navigate_next" -}}
+          </span>
+        </a>
+      </li>
+      {{- else }}
+      <li>
+        <a class="{{ $disabled }}" aria-disabled="true" aria-label="Last">
+          <span class="icon-svg">
+            {{- partialCached "icon" "navigate_next" "navigate_next" -}}
+          </span>
+        </a>
+      </li>
+      {{- end }}
+    {{- end }}
+  {{- end }}
+  </ul>
+{{- end }}
+

layouts/partials/tags.html

@@ -0,0 +1,13 @@
+{{- /*
+  List of tag "chips" as links
+  Context: page.Pages
+  */ -}}
+{{- range . -}}
+{{- if eq .File nil }}
+  {{- errorf "[tags] Undefined tag: '%s' in %s" (urlize (strings.ToLower .Title)) page.File.Filename }}
+{{- end }}
+<a class="flex items-center gap-2 lg:text-base px-2 rounded text-gray-light-800 bg-gray-light-200 dark:bg-gray-dark-300 dark:text-gray-dark-800" href="{{ .Permalink }}">
+  <div class="icon-svg icon-sm pb-0.5">{{ partialCached "icon" .Params.icon .Params.icon }}</div>
+  <div>{{ .LinkTitle }}</div>
+</a>
+{{- end -}}

layouts/partials/toc-default.html

@@ -1,8 +0,0 @@
-{{ if ne .Params.notoc true }}
-  {{ if gt (len .TableOfContents) 32 }}
-    <div>
-      <div class="text-lg pb-2">{{ T "tableOfContents" }}</div>
-      {{ .TableOfContents }}
-    </div>
-  {{ end }}
-{{ end }}

layouts/partials/top-nav.html

@@ -4,7 +4,7 @@
   <nav>
     <ul class="box-content flex mt-1 gap-4 md:hidden">
       {{ range site.Menus.main }}
-      <li {{- if eq $firstSection .Name }} class="border-b-4" {{- end }}>
+      <li {{- if or (eq $firstSection .Name)  }} class="border-b-4" {{- end }}>
         <a class="block py-1 px-2" href="{{ .URL }}">{{ .Name }}</a>
       </li>
       {{ end }}

layouts/tag/baseof.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+  {{ partial "head.html" . }}
+</head>
+
+<body class="flex flex-col min-h-screen bg-background-light text-base dark:bg-background-dark dark:text-white">
+  {{ partial "header.html" . }}
+  <main class="flex justify-center">
+    <div class="w-[1200px] overflow-clip p-6 pt-0 md:w-lvw">
+      {{ block "main" . }}
+      {{ end }}
+    </div>
+  </main>
+  <footer class="mt-auto">{{ partialCached "footer.html" . }}</footer>
+</body>
+
+</html>

layouts/tag/taxonomy.html

@@ -0,0 +1,19 @@
+{{ define "main" }}
+  {{ partial "breadcrumbs.html" . }}
+  <article class="DocSearch-content prose max-w-none dark:prose-invert">
+    <h1 class="scroll-mt-36">{{ .Title }}</h1>
+    {{ .Content }}
+    <div class="grid grid-cols-3 gap-4 sm:flex sm:flex-col lg:grid-cols-2">
+    {{ range site.Taxonomies.tags }}
+    {{ partial "components/card.html"
+      (dict
+        "link" .Page.Permalink
+        "title" .Page.Title
+        "description" .Page.Description
+        "icon" .Page.Params.icon
+      )
+    }}
+    {{ end }}
+    </div>
+  </article>
+{{ end }}

layouts/tag/term.html

@@ -0,0 +1,44 @@
+{{ define "main" }}
+  {{ partial "breadcrumbs.html" . }}
+  <article class="DocSearch-content prose max-w-none dark:prose-invert">
+    <a class="link" href="/tags/"><span class="icon-svg">{{ partialCached "icon" "navigate_before" "navigate_before" }}</span>View all tags</a>
+    <h1 class="scroll-mt-36 flex gap-4 items-center">
+      <span class="bg-gray-light-200 dark:bg-gray-dark-300 rounded-full px-3 icon-svg icon-lg pb-2">{{ partialCached "icon" .Params.icon .Params.icon }}</span>
+      </span>{{ .Title }}</span>
+    </h1>
+    {{ .Content }}
+    <div class="not-prose flex justify-between items-center">
+      <span class="text-gray-light dark:text-gray-dark">Pages with this tag:</span>
+      {{ partial "pagination.html" . }}
+    </div>
+    <table>
+      <thead>
+        <tr>
+          <th width="50%">Title</th>
+          <th width="50%">Section</th>
+        </tr>
+      </thead>
+      <tbody>
+        {{ range .Paginator.Pages }}
+        {{ $scratch := partialCached "utils/tocparser.html" . . }}
+        {{ $sections := $scratch.GetSortedMapValues "sections" }}
+        <tr>
+          <td>
+            <a href="{{ .Permalink }}" class="link">
+              {{ .Title }}
+            </a>
+          </td>
+          <td>
+            <span class="text-gray-light dark:text-gray-dark">
+              {{ range $i, $e := $sections }}
+                {{ if $i }} / {{ end }}
+                {{ $e.title }}
+              {{ end }}
+            </span>
+          </td>
+        </tr>
+        {{ end }}
+      </tbody>
+    </table>
+  </article>
+{{ end }}

netlify.toml

@@ -4,7 +4,7 @@ publish = "public"
 [context.deploy-preview.environment]
 NODE_VERSION = "20"
 NODE_ENV = "production"
-HUGO_VERSION = "0.122.0"
+HUGO_VERSION = "0.124.1"
 HUGO_ENABLEGITINFO = "true"
 HUGO_ENVIRONMENT = "preview"