Skip to content

docs: add DCT retirement warning to trust how-to pages - #26681

Open
jaeyeonme wants to merge 1 commit into
docker:mainfrom
jaeyeonme:docs/dct-retirement-notices
Open

jaeyeonme wants to merge 1 commit into
docker:mainfrom
jaeyeonme:docs/dct-retirement-notices

Conversation

@jaeyeonme

Copy link
Copy Markdown

Description

The Content trust overview warns that DCT is being retired and that
notary.docker.io shuts down on December 8, 2026. The five how-to pages under
it don't, so readers who land on them from search follow DCT setup steps
without seeing the notice.

This copies the overview's warning, unchanged, to the top of each page. It's
the same pattern as the Autobuilds deprecation (#24981), which repeats one
callout across every page in that section.

Related issues or tickets

Closes #26286

#26287 made the same change but was closed by its author before review.

Reviews

  • deploying_notary.md covers self-hosting Notary Server, so the
    notary.docker.io sentence applies to it less directly. I kept the wording
    identical on all five pages; happy to adjust it for that page.
  • Remove outdated version requirements from trust sandbox prerequisites #25298 also edits trust_sandbox.md, but only the front matter, so the two
    changes don't overlap.
  • The shutdown is on December 8, so this is time-sensitive.

rumdl 0.2.49 and Vale 3.17.0 report nothing on the added lines.

AI disclosure: I used Claude Code to check the pages against main, find the
Autobuilds precedent, make the edit, run the linters, and draft this
description. I reviewed the diff and this text before posting.

  • Technical review
  • Editorial review
  • Product review

The Content trust overview warns that DCT is being retired and that
notary.docker.io shuts down on December 8, 2026, but the five how-to
pages under it don't. Copy the overview's warning to the top of each
page, matching how the Autobuilds deprecation notice is repeated across
its section.

Closes docker#26286
@jaeyeonme
jaeyeonme requested a review from dvdksn as a code owner November 19, 2026 10:58
@github-actions github-actions Bot added area/engine Issue affects Docker engine/daemon area/security labels Nov 19, 2026
@netlify

netlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit c615654
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6afed64df0ad4916303338fb
😎 Deploy Preview https://deploy-preview-26681--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.

@dvdksn dvdksn left a comment

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.

LGTM

@dvdksn
dvdksn requested review from craig-osterhout and a balanced review from Copilot November 19, 2026 11:00

Copilot AI left a comment

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.

🟢 Approval recommended

No active review issues are recorded for the change adding DCT retirement warnings to all five trust how-to pages.

No open issues 🎉

What changed in this PR

Adds the existing Docker Content Trust (DCT) retirement warning to all five trust how-to pages, so readers arriving directly see it before following setup instructions. This addresses #26286 without changing the procedures.

Changes:

  • Repeats the overview’s warning unchanged at the top of each page.
  • States the December 8, 2026 shutdown date for notary.docker.io and links to the retirement guidance.
File Description
content/​manuals/​engine/​security/​trust/​trust_sandbox.md Adds the warning before sandbox setup instructions.
content/​manuals/​engine/​security/​trust/​trust_key_mng.md Adds the warning before key-management guidance.
content/​manuals/​engine/​security/​trust/​trust_delegation.md Adds the warning before delegation guidance.
content/​manuals/​engine/​security/​trust/​trust_automation.md Adds the warning before automation instructions.
content/​manuals/​engine/​security/​trust/​deploying_notary.md Adds the warning before self-hosted Notary deployment instructions.

Review effort: Balanced

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/engine Issue affects Docker engine/daemon area/security

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-scanner] DCT retirement notice missing from trust documentation pages

3 participants