publish updates from main

content/manuals/engine/release-notes/28.md

@@ -23,6 +23,29 @@ For more information about:
 - Deprecated and removed features, see [Deprecated Engine Features](../deprecated.md).
 - Changes to the Engine API, see [Engine API version history](/reference/api/engine/version-history.md).
 
+## 28.1.1
+
+{{< release-date date="2025-04-18" >}}
+
+For a full list of pull requests and changes in this release, refer to the relevant GitHub milestones:
+
+- [docker/cli, 28.1.1 milestone](https://github.com/docker/cli/issues?q=is%3Aclosed+milestone%3A28.1.1)
+- [moby/moby, 28.1.1 milestone](https://github.com/moby/moby/issues?q=is%3Aclosed+milestone%3A28.1.1)
+
+### Bug fixes and enhancements
+
+- Fix `dockerd-rootless-setuptool.sh` incorrectly reporting missing `iptables`. [moby/moby#49833](https://github.com/moby/moby/pull/49833)
+- containerd image store: Fix a potential daemon crash when using `docker load` with archives containing zero-size tar headers. [moby/moby#49837](https://github.com/moby/moby/pull/49837)
+
+### Packaging updates
+
+- Update Buildx to [v0.23.0](https://github.com/docker/buildx/releases/tag/v0.23.0). [docker/docker-ce-packaging#1185](https://github.com/docker/docker-ce-packaging/pull/1185)
+- Update Compose to [v2.35.1](https://github.com/docker/compose/releases/tag/v2.35.1). [docker/docker-ce-packaging#1188](https://github.com/docker/docker-ce-packaging/pull/1188)
+
+### Networking
+
+- Add a warning to a container's `/etc/resolv.conf` when no upstream DNS servers were found. [moby/moby#49827](https://github.com/moby/moby/pull/49827)
+
 ## 28.1.0
 
 {{< release-date date="2025-04-17" >}}

content/reference/glossary.md

@@ -3,10 +3,21 @@ title: Glossary
 description: Glossary of terms used around Docker
 keywords: glossary, docker, terms, definitions
 notoc: true
+layout: glossary
 aliases:
 - /engine/reference/glossary/
 - /glossary/
 ---
 
-Need a definition? Docker's AI-powered assistant can help. Select **Ask AI** in the
-top navigation and ask it to define a term.
+> [!TIP]
+>
+> Looking for a definition that's not listed or need a more context-aware
+> explanation?
+>
+> Try <a role="button" tabindex="0" class="open-kapa-widget">Ask AI</a>.
+
+
+<!--
+To edit/add/remove glossary entries, visit the YAML file at:
+https://github.com/docker/docs/blob/main/data/glossary.yaml
+-->

data/glossary.yaml

@@ -0,0 +1,78 @@
+base image: |
+  A base image is an image you designate in a `FROM` directive in a Dockerfile.
+  It defines the starting point for your build.
+  Dockerfile instructions create additional layers on top of the base image.
+  A Dockerfile with the `FROM scratch` directive uses an empty base image.
+
+build: |
+  Build is the process of building Docker images using a Dockerfile. The build
+  uses a Dockerfile and a "context". The context is the set of files in the
+  directory in which the image is built.
+
+container: |
+  A container is a runnable instance of an image. You can start, stop, move, or
+  delete a container using the Docker CLI or API. Containers are isolated from
+  one another and the host system but share the OS kernel. They provide a
+  lightweight and consistent way to run applications.
+
+context: |
+  A Docker context contains endpoint configuration for the Docker CLI to connect
+  to different Docker environments, such as remote Docker hosts or Docker
+  Desktop. Use `docker context use` to switch between contexts.
+
+Docker CLI: |
+  The Docker CLI is the command-line interface for interacting with the Docker
+  Engine. It provides commands like `docker run`, `docker build`, `docker ps`,
+  and others to manage Docker containers, images, and services.
+
+Docker Compose: |
+  Docker Compose is a tool for defining and running multi-container Docker
+  applications using a YAML file (`compose.yaml`). With a single command, you
+  can start all services defined in the configuration.
+
+Docker Desktop: |
+  Docker Desktop is an easy-to-install application for Windows, macOS, and Linux
+  that provides a local Docker development environment. It includes Docker
+  Engine, Docker CLI, Docker Compose, and a Kubernetes cluster.
+
+Docker Engine: |
+  Docker Engine is the client-server technology that creates and runs Docker
+  containers. It includes the Docker daemon (`dockerd`), REST API, and the
+  Docker CLI client.
+
+Docker Hub: |
+  Docker Hub is Docker’s public registry service where users can store, share,
+  and manage container images. It hosts Docker Official Images, Verified
+  Publisher content, and community-contributed images.
+
+image: |
+  An image is a read-only template used to create containers. It typically
+  includes a base operating system and application code packaged together using
+  a Dockerfile. Images are versioned using tags and can be pushed to or pulled
+  from a container registry like Docker Hub.
+
+layer: |
+  In an image, a layer is a modification represented by an instruction in the
+  Dockerfile. Layers are applied in sequence to the base image to create the
+  final image. Unchanged layers are cached, making image builds faster and more
+  efficient.
+
+multi-architecture image: |
+  A multi-architecture image is a Docker image that supports multiple CPU
+  architectures, like `amd64` or `arm64`. Docker automatically pulls the correct
+  architecture image for your platform when using a multi-arch image.
+
+persistent storage: |
+  Persistent storage or volume storage provides a way for containers to retain
+  data beyond their lifecycle. This storage can exist on the host machine or an
+  external storage system and is not tied to the container's runtime.
+
+registry: |
+  A registry is a storage and content delivery system for Docker images. The
+  default public registry is Docker Hub, but you can also set up private
+  registries using Docker Distribution.
+
+volume: |
+  A volume is a special directory within a container that bypasses the Union
+  File System. Volumes are designed to persist data independently of the
+  container lifecycle. Docker supports host, anonymous, and named volumes.

hugo.yaml

@@ -134,10 +134,10 @@ params:
   # Latest version of the Docker Engine API
   latest_engine_api_version: "1.49"
   # Latest version of Docker Engine
-  docker_ce_version: "28.1.0"
+  docker_ce_version: "28.1.1"
   # Previous version of the Docker Engine
   # (Used to show e.g., "latest" and "latest"-1 in engine install examples
-  docker_ce_version_prev: "28.0.4"
+  docker_ce_version_prev: "28.1.0"
   # Latest Docker Compose version
   compose_version: "v2.35.0"
   # Latest BuildKit version

layouts/_default/glossary.html

@@ -0,0 +1,39 @@
+{{ define "left" }}
+  {{ partial "sidebar/mainnav.html" . }}
+  {{ partial "sidebar/sections.html" . }}
+{{ end }}
+
+{{ define "main" }}
+  {{ partial "breadcrumbs.html" . }}
+  <article class="prose max-w-none dark:prose-invert">
+    {{ with .Title }}
+    <h1 class="scroll-mt-36">{{ . }}</h1>
+    {{ end }}
+    {{ with .Content }}
+      {{ .  }}
+    {{ end }}
+    <table>
+      <thead>
+        <tr>
+          <th>Term</th>
+          <th>Definition</th>
+        </tr>
+      </thead>
+      <tbody>
+        {{ range $term, $definition := site.Data.glossary }}
+          <tr>
+            <td class="not-prose">
+              <a class="-top-16 relative" name="{{ $term | anchorize }}"></a>
+              {{ $term }}
+            </td>
+            <td>{{ $definition | $.RenderString }}</td>
+          </tr>
+        {{ end }}
+      </tbody>
+    </table>
+  </article>
+{{ end }}
+
+{{ define "right" }}
+  {{ partial "aside.html" . }}
+{{ end }}