Skip to content

dhi: update customizations#24503

Merged
craig-osterhout merged 1 commit intodocker:mainfrom
craig-osterhout:engdocs-3218-2
Mar 24, 2026
Merged

dhi: update customizations#24503
craig-osterhout merged 1 commit intodocker:mainfrom
craig-osterhout:engdocs-3218-2

Conversation

@craig-osterhout
Copy link
Copy Markdown
Contributor

Description

Follow up to #24500. I incorrectly interpreted and tested only the distros and not the distro versions.

The UI wording is dynamic based on distro and version. I removed the UI wording instead of updating as it makes the simple step more complex than necessary by having to explain an insignificant UI quirk. Added the explanation to the paragraph below the main step text.

Debian UI wording is Packages
Alpine 3.22 UI wording is Packages
Alpine 3.23 UI wording is Hardened Packages

Related issues or tickets

ENGDOCS-3218

Reviews

  • Editorial review

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 24, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit d270aee
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69c2b25048c45500088964f5
😎 Deploy Preview https://deploy-preview-24503--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

This PR correctly updates the package customization documentation to reflect the version-specific behavior of Docker Hardened Images. The change clarifies that Alpine 3.23 has hardened packages while Alpine 3.22 and Debian have standard packages, which matches the author's testing.

The removal of bold formatting from "Packages" is a minor style choice. While the style guide permits bolding UI elements, the author chose to simplify the instruction by removing the UI-specific wording, which is reasonable given the dynamic nature of the UI labels across versions.

No issues found in the changed code.

@craig-osterhout craig-osterhout requested a review from a team March 24, 2026 15:52
@craig-osterhout craig-osterhout added the status/review Pull requests that are ready for review label Mar 24, 2026
@craig-osterhout craig-osterhout enabled auto-merge (squash) March 24, 2026 15:56
packages that have been built from source by Docker with cryptographic
signatures and full supply chain security. For Debian-based images,
these are standard Debian system packages.
selected image variant. For version 3.23 Alpine-based images, these are
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess this won't be evergreen - in about two months from now we'll have 3.24 images. So we'll either need to go back here and update at that point, or we rephrase this to say call out say something like Alpine images, except 3.22, contain hardened packages, ...

@craig-osterhout craig-osterhout merged commit ac73fd8 into docker:main Mar 24, 2026
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/dhi status/review Pull requests that are ready for review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants