1
0
mirror of https://github.com/docker/docs.git synced 2026-10-25 06:09:46 +03:00
Commit Graph

213 Commits

Author SHA1 Message Date
Alexa Kristensen
b744dd3103 docs: restructure Platform accounts, security, and billing IA (#25982)
# To dos

~- Evaluate _index pages and standardize across account + admins
category~
~- Edit weights of topics~
- Notify TSEs, other stakeholders
- TW sign off 

## Summary

This PR restructures the Platform documentation into a clearer Accounts,
Security, and Subscription and billing information architecture, with
aliases so existing URLs keep working.

Work from these PRs was merged into this feature branch:

- #25957 (Security IA)
- #25960 (Accounts and Admin)
- #25981 (Subscription and billing)

### Accounts

- Moves organization, company, and admin content under Accounts.
- Splits individual-account docs into their own subsection.
- Removes the standalone Admin section; those pages now live under
Accounts.

### Security

- Publishes Security at `/security/`, matching other Platform sections.
- Groups authentication (SSO, 2FA, OIDC), access tokens, provisioning,
and roles under Security.
- Leaves Enterprise Hardened Desktop and related enterprise security
docs under Enterprise.
- Restores shipped Hardened Desktop and security FAQ URLs so they match
`main`.

### Subscription and billing

- Merges Subscription and Billing into a single Subscription and billing
section.
- Drops the extra subcategory wrappers and nests billing tasks under
Manage.
- Shortens the billing details sidebar label.

### FAQs

- Consolidates Platform FAQs onto four pages: Accounts, Security,
Subscription and billing, and Platform.
- Folds leftover general, container, and network/VM security FAQs into
Platform FAQs.
- Folds SSO enforcement FAQs into the SSO FAQ.
- Templates FAQ pages with H2 topics and H3 questions, and limits the
table of contents to H2.

### Navigation and follow-ups

- Renames the manuals sidebar group from Platform to Accounts and admin,
and updates the manuals landing heading and copy to match.
- Fixes the MSI install Settings Management link after the security path
move.
- Updates CODEOWNERS, the labeler, and in-repo links to the new paths.

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-03 09:26:12 -07:00
Allie Sadler
b6abe9c909 4.86 security item (#25776)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: aevesdocker <allie.sadler@docker.com>
2026-08-11 09:01:57 +01:00
Allie Sadler
64f919ca59 engdocs-3347 (#25573)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: aevesdocker <allie.sadler@docker.com>
2026-07-15 13:59:20 +01:00
Alexa Kristensen
2e38548a15 Fix misleading and stale content across admin, security, and subscription docs (#25415)
## Summary

Fix misleading descriptions, stale tense, and contradictory statements
across admin, security, SSO, MCP profiles, and subscription scaling
documentation.

Closes #24893
Closes #24894
Closes #25024
Closes #25058
Closes #25261
Closes #25300

Generated by Cursor (Claude)

Made with [Cursor](https://cursor.com)

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-23 09:05:32 -05:00
Kyle Trantham
46001a40dd Add security release notes for CVE-2026-5817 and CVE-2026-5843 (#25107)
## Summary

Adds Security subsections to Docker Desktop 4.68.0 and 4.71.0 release
notes and corresponding entries in the security announcements page for
two Docker Model Runner container-to-host code execution issues that
have already shipped fixes.

- **CVE-2026-5817** — Docker Model Runner vllm-metal trust_remote_code
RCE (fixed in DD 4.68.0, April 7)
- **CVE-2026-5843** — Docker Model Runner MLX-LM model_file importlib
RCE (fixed in DD 4.71.0, April 27)

Mirrors the style of #24565 and #24207. Both fixed releases are already
live, so this back-fills the Security sections required to reference
from the corresponding CVE records.

## Test plan

- [ ] Verify Security subsection renders under DD 4.71.0 with link to
CVE-2026-5843
- [ ] Verify Security subsection renders under DD 4.68.0 with link to
CVE-2026-5817
- [ ] Verify two new entries appear at top of security-announcements.md
- [ ] Confirm CVE.org links resolve (currently will show RESERVED until
CVE records are published)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 07:42:51 +01:00
David Karlsson
ee71c80562 chore: migrate icons from Material Symbols to Heroicons
Replaces @material-symbols/svg-400 (5.5 MB) with heroicons (488 KB) — an
11x reduction in icon asset size. Heroicons uses a single consistent
distribution format (24px solid SVGs, fill="currentColor") eliminating
the need for the separate utils/svg.html partial, the icon-svg-stroke CSS
utility, and the dual-path resolution logic in icon.html.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-05-18 12:05:54 +02:00
Alexa Kristensen
3619fb1780 Admin IA refresh (#24852)
PR to capture work:

- Update / simplify titles to match docs
- Create subcategories within org/company
- Wrestle with redirect nightmare part 2

Filing a follow up PR to create parallel structure in the `Company`
subcategory. This PR's scope is for `Organization` only.
2026-04-23 07:30:04 -05:00
lacatoire
24155e8620 Remove roadmap language from security FAQ
Remove "on the roadmap" and "currently" from the extension security
vetting FAQ entry, keeping a timeless factual statement per STYLE.md
conventions.

Fixes #24490
2026-03-31 11:06:44 +02:00
Luca Guerra
bc0358ad62 4.67 security release notes (#24565)
## Description

Add security notes to the 4.67.0 release

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-03-30 11:31:24 +01:00
David Karlsson
6dabf0d176 deps: upgrade npm dependencies
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-03-17 09:19:07 +01:00
Quentin Laplanche
8f54d121c3 Add security content note for Docker Desktop 4.62.0 release (#24236)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

As per title, add security note. Once approved, the CVE details will be
published.

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-02-27 16:30:01 +00:00
Luca Guerra
1ca3e4365e Add security content note for Docker Desktop 4.62.0 release (#24207)
<!--Delete sections as needed -->

## Description

As per title, add security note. Once approved, the CVE details will be
published.

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Co-authored-by: docker-agent[bot] <259137750+docker-agent[bot]@users.noreply.github.com>
2026-02-24 10:10:18 +00:00
David Karlsson
dde88001b6 site: simplify security-announcements rss page
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2026-02-23 17:29:32 +01:00
temenuzhka-thede
2e07997f0a Update security-announcements.md for CVE-2025-13743 (#23825)
Update security notes to reference CVE-2025-13743
https://www.cve.org/CVERecord?id=CVE-2025-13743

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-12-10 18:20:17 +00:00
Allie Sadler
a67aed7688 ENGDOCS-2812 (#23661)
<!--Delete sections as needed -->

## Description

Moves some remaining enterprise FAQs 

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-11-05 09:49:41 +00:00
Allie Sadler
afac884db1 DD release notes: security addition (#23614)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-10-27 15:37:32 +00:00
Cesar Talledo
47546555f8 Add security notices regarding CVE-2025-10657. (#23476)
<!--Delete sections as needed -->

## Description

Add notices to the 4.47.0 release notes and the security announcements
page.

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [X] Editorial review
- [ ] Product review

Signed-off-by: Cesar Talledo <cesar.talledo@docker.com>
2025-10-01 08:10:23 +01:00
Chris Crone
71e696fcdf Fix 4.44.3 security announcement date (#23337)
## Description

Noticed that the date for the 4.44.3 Desktop release was incorrect and
corrected it.

Signed-off-by: Chris Crone <christopher.crone@docker.com>
2025-09-01 15:35:15 +01:00
Sarah Sanders
d64a65a33e security: add RSS feed option (#23328)
Do not merge, we need to configure some behavior rules in CloudFront

## Description
Adds an RSS feed subscription option to the security announcements page.
We can reuse this shortcode for other release notes or announcements
pages if we want!

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2939

## Reviews
- [ ] Editorial review
2025-08-29 15:19:40 -04:00
Sebastiaan van Stijn
0d624c8a71 add missing redirect for "disable two-factor authentication" (#23299)
- relates to https://github.com/docker/docs/pull/23230
- fixes https://github.com/docker/docs/issues/23298


The old page was removed in f77ddf3728,
but didn't add a redirect.

<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2025-08-26 13:14:37 +01:00
Allie Sadler
37e705cec4 release link (#23282)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-08-20 13:37:57 +00:00
Allie Sadler
2afdd47e71 4.44.3 release notes (#23281)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-08-20 14:20:09 +01:00
Sarah Sanders
f77ddf3728 freshness: security and subscription (#23230)
<!--Delete sections as needed -->

## Description
Final freshness updates for Security and Subscription pages. Apologies
ahead of time, it is a lot of file updates :')

Updates include:
- Major overhaul of ECI content (this could use the most review)
- Fine tuning of the rest of the docs in these sections (includes
consistency with headings/formatting, page structure, fixing passive
voice, simplifying)
- Deleted all content shortcodes 🥳 

_Vale errors can mostly be ignored unless you see something glaringly
wrong. I addressed all the typo/spelling ones, and added some terms to
accept.txt_

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2918

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-08-15 15:16:15 -07:00
george
fea83f1852 Docker Desktop 4.44.0 release notes (#23173)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: aevesdocker <allie.sadler@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2025-08-07 11:14:46 +01:00
Arthur
7193d2a882 chore: reduce noice in Vale error reporting (#23146)
Exclude extra release notes from Spelling/Term checks.
Exclude `<a>` from checks.
Add new terms and fix some double space errors.

- Before: 2691
- After: 967
2025-07-24 11:04:55 +02:00
Allie Sadler
d4ce08a39c enterprise: move content (#23100)
<!--Delete sections as needed -->

## Description

Part of https://docker.atlassian.net/browse/ENGDOCS-2836

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-18 07:49:29 +01:00
Sarah Sanders
5dd8bad4e7 restore Enterprise docs changes (#23094)
Reverts docker/docs#23091 to restore Enterprise doc changes
2025-07-14 17:16:32 -04:00
Sarah Sanders
50c2a3b141 Revert "Enterprise docs section" (#23091)
Reverts docker/docs#23083
2025-07-14 16:36:46 -04:00
Allie Sadler
79d3d6f127 Enterprise docs section (#23083)
<!--Delete sections as needed -->

## Description

As per https://docker.atlassian.net/browse/ENGDOCS-2836

Next up:
 - tidy up/ split the security FAQs
 - move the 'for developers' content up one level
 - beef up the Deploy DD page
 - AOB

(didn't want to include in this PR as it's already too long)

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-14 16:13:54 +01:00
Sarah Sanders
6fc9fe8b93 Merge pull request #23071 from sarahsanders-docker/roles-permissions-update
security: update roles and permissions
2025-07-14 10:35:13 +01:00
Sarah Sanders
5f58093454 security: move domain audit (#23064)
## Description
- Moved domain audit under "domain management" since the UI has changed,
it will no longer be deprecated, and it makes sense in the context of
other domain management features

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2830

## Reviews
- [ ] Editorial review

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-07-10 15:33:48 -04:00
Craig Osterhout
1b70e4d481 Merge pull request #23062 from craig-osterhout/update-relative-links
update links
2025-07-10 08:52:16 -07:00
Craig
4674c284d6 update links
Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-10 08:39:49 -07:00
Craig
5c6219a3ce fix link
Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-09 20:46:45 -07:00
Allie Sadler
bf600c694f Revert "Adjust a note regarding Kubernetes custom registry images with ECI." (#23036)
Reverts docker/docs#23021
2025-07-09 10:33:54 +01:00
Sarah Sanders
f0dee0b3ef security: add k8s setting to reference (#23026)
## Description
- Adds a callout to enable K8s setting
- Adds "Custom K8s image repository" setting
- Adds Admin Console as an option for configuring network settings
- Adds min DD version to network settings in reference

## Related issues or tickets
- https://docker.atlassian.net/browse/ENGDOCS-2722
- https://docker.atlassian.net/browse/ENGDOCS-2719
- https://docker.atlassian.net/browse/ENGDOCS-2820

## Reviews
- [ ] Editorial review
2025-07-08 12:08:09 -04:00
Cesar Talledo
6fbd921eed Merge pull request #23021 from ctalledo/eci-k8s-custom-registry-note
Adjust a note regarding Kubernetes custom registry images with ECI.
2025-07-08 08:04:02 +01:00
Allie Sadler
7107a8e8bc RN cve (#22996)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-07-03 17:13:13 +01:00
Arthur
81c5cf9c23 Merge pull request #22914 from ArthurFlag/AIE-230-docs-cors-config-in-dd
CORS support
2025-07-03 14:36:37 +01:00
Sarah Sanders
03a53e0368 Merge pull request #22985 from sarahsanders-docker/min-version-settings
fix: update min. version for settings management
2025-07-02 16:27:49 -04:00
Sarah Sanders
683bd2268b Merge pull request #22947 from sarahsanders-docker/sidenav-release
cx: update docs for new sidenav
2025-07-02 16:18:30 -04:00
Sarah Sanders
c2fcd81872 Revert "chore: update UI steps for new side nav" (#22931)
I merged too early, need to revert - this is going out next week.
2025-06-26 13:48:37 -04:00
Sarah Sanders
0e39ab8cc4 chore: update UI steps for new side nav (#22911)
## Description
- The Admin Console has a new navigation, starting w/ Docker Home >
Admin Console > expanded side nav
- Updates UI steps across docs site for Admin Console updates
- Also removes Domain audit docs, this section of the Admin Console/Hub
has been deprecated and replaced with Domain management

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2746

## Reviews
- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-26 09:15:37 -04:00
Sarah Sanders
101db0dc4a security: update IAM/RAM docs for OATs compatibility (#22915)
## Description
- IAM and RAM do not work with OATs
- This adds callouts/clarification on incompatibility

## Related issues or tickets

https://docker.atlassian.net/browse/ENGDOCS-2759?atlOrigin=eyJpIjoiMWY0ODA5ZmRlMzNjNDlkZTlhYjZmY2NlY2M1NWU1MjUiLCJwIjoiaiJ9

## Reviews
- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-25 10:04:23 -04:00
Sarah Sanders
0f98203b09 Merge pull request #22894 from sarahsanders-docker/settings-ref-versions
security: update DD versions for settings reference
2025-06-24 14:13:12 -04:00
Sarah Sanders
804ee1b25c Merge pull request #22868 from sarahsanders-docker/oats-scout
security: update OATs incompatibility
2025-06-23 09:10:10 -04:00
karman
8d1e1d3591 update container proxy behaviour with PAC file (#22847)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

Relates to this code changes in
https://github.com/docker/pinata/pull/34220 and
https://github.com/docker/pinata/pull/34955. This PR updates the docs to
reflect the new behaviour.

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [X] Technical review
- [X] Editorial review
- [ ] Product review
2025-06-20 15:58:29 +01:00
sarahsanders-docker
34bc5ca86d security: remove Scout incompatible for OATs 2025-06-18 15:00:30 -04:00
Sarah Sanders
edd8605f4b security: update SCIM docs for Azure OIDC (#22771)
## Description
- Adds section to SCIM docs for Entra ID/Azure OIDC
- Adds testing section to SCIM doc
- Adds troubleshooting guide for provisioning
- Fixes numbers to 1,1,1 format
- Ignore vale

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2648

## Reviews
- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-06-11 09:59:33 -04:00
Sarah Sanders
859afee84e chore: add blog post to learn more section of settings management (#22792)
## Description
- Request from Product and Marketing, add blog post under "Learn more"
heading for Settings Management guide

## Related issues or tickets
https://docker.atlassian.net/browse/ENGDOCS-2697

## Reviews
- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-06-06 09:24:43 -04:00