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

24 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
Tiara Johnson
1c519b2a8f Contact Sales CTAs tracking id (#25267)
<!--Delete sections as needed -->

## Description
Adding element ids to Contact Sales CTAs in all of Docs. This will allow
us to track funnel metrics better.

https://docs.google.com/spreadsheets/d/1NBEpc3ZZNnF8CH-XU34AKRERoTye3QBCCdRyNpGDjRE/edit?usp=sharing

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

## Related issues or tickets
https://docker.atlassian.net/browse/GRO-376

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

## Reviews

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

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2026-06-05 07:32:08 -05:00
Leo
0f9dc094d1 Offload: update offload idle behaviour description (#24829)
<!--Delete sections as needed -->

## Description

Updates the description of Offload session management and idle behaviour

## Related issues or tickets

DCL-1716

## Reviews

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

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

---------

Co-authored-by: Craig Osterhout <craig.osterhout@docker.com>
2026-05-22 07:52:50 -07: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
Usha Mandya
9936e9387c Merge pull request #25010 from usha-mandya/product-buckets
Update side nav to reflect current product groupings
2026-05-11 14:11:34 +01:00
Usha Mandya
997b3b5f90 update side nav groups
Signed-off-by: Usha Mandya <usha.mandya@docker.com>
2026-05-11 13:36:30 +01:00
Usha Mandya
8a33bc7e27 docs: clarify fair use totals across all user sessions
The fair use definition lacked clarity that the 8-hour compute limit
applies across all user sessions combined. Added "totaled across all user
sessions" to make this explicit.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 11:45:22 +01:00
Craig Osterhout
75274a2de0 offload: add fair use (#24891)
<!--Delete sections as needed -->

## Description

Added explicit fair use policy in its own section.

## Related issues or tickets

ENGDOCS-3266

## Reviews

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

- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-28 13:20:26 -07: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
Alexa Kristensen
6d61abd2a8 SCIM jit edits (#24600)
just a lot of stuff that got out of hand idk. it started out as a nice
reorg of provision and turned into a nightmare of my own making
2026-04-20 08:44:44 -05:00
Craig Osterhout
f229d48c47 offload: version update (#24680)
<!--Delete sections as needed -->

## Description

Updated min version supported by Offload to 4.68 for nudge
functionality.

## Related issues or tickets


https://docker.slack.com/archives/C09ARNANZCJ/p1775759784277949?thread_ts=1775557490.573449&cid=C09ARNANZCJ

## Reviews

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

- [ ] Technical review

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-10 07:32:37 +01:00
Craig Osterhout
d72c32e321 offload: product updates (#24487)
<!--Delete sections as needed -->

## Description

Updates for upcoming Offload release.

Preview:
- https://deploy-preview-24487--docsdocker.netlify.app/offload/
-
https://deploy-preview-24487--docsdocker.netlify.app/desktop/setup/vm-vdi/#use-docker-offload

## Related issues or tickets

ENGDOCS-3216
DCL-1433
#24089

## Reviews

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

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

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2026-04-02 10:18:14 -07:00
David Karlsson
3d8c8725a2 offload: remove Beta label and fix trial expiration note
Remove the "Docker Offload Beta" product-stage label from the trial
expiration note (the product is Early Access, not Beta). Simplify
the time-relative phrase "from the time they are granted".

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-19 11:32:59 +00:00
Allie Sadler
aa2c38f196 Desktop: update issue tracker links (#23976)
<!--Delete sections as needed -->

## Description

issue tracker for DD will change in 4.57 release

## 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
2026-01-19 11:08:38 +00:00
Craig Osterhout
e9ad5f424e offload: enterprise ea (#23632)
<!--Delete sections as needed -->

## Description

Updated Offload Beta docs for enterprise EA.

Notable topics updated:

- [All topics under
`/offload/`](https://deploy-preview-23632--docsdocker.netlify.app/offload/)
- [Manage Docker
products](https://deploy-preview-23632--docsdocker.netlify.app/admin/organization/manage-products/)
- [Settings reference - Enable Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/enterprise/security/hardened-desktop/settings-management/settings-reference/#enable-docker-offload)
- [Settings - Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/desktop/settings-and-maintenance/settings/#docker-offload)
- [VM/VDI - Use Docker
Offload](https://deploy-preview-23632--docsdocker.netlify.app/desktop/setup/vm-vdi/#use-docker-offload)
- [Docker Offload CLI
reference](https://deploy-preview-23632--docsdocker.netlify.app/reference/cli/docker/offload/)

~~**Pending audit log updates**~~ Will handle in followup PR to keep
this moving

## Related issues or tickets

DCL-745
DCL-1033
DCL-1019
ENGDOCS-2929

## Reviews

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

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

---------

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
2025-11-06 23:54:16 -08:00
Sarah Sanders
5f79dd99df billing: update usage terminology (#23443)
## Description
- Remove "credits" and "budget" from docs, to use term "usage"

## Related issues or tickets

https://docker.atlassian.net/browse/ENGDOCS-2934?atlOrigin=eyJpIjoiMDIzNGJlNzFiZjlhNGI4NjhkOGVkNjExNzA0MzlmZTYiLCJwIjoiaiJ9
2025-09-23 13:36:35 -04:00
Tadashi Nemoto
67e9f7bf4d Update offload optimize.md (#23415)
`###` should be `##`

<!--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-09-17 09:59:42 -07:00
Craig Osterhout
aa15629e51 offload: add trial credit expiration note (#23252)
<!--Delete sections as needed -->

## Description

Add temporary note about free trial credit expiration.

https://deploy-preview-23252--docsdocker.netlify.app/offload/usage/

## Related issues or tickets

DCL-669

## Reviews

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

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

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-08-20 09:36:54 -07:00
Craig Osterhout
985dfc6c7c offload: add survey link to docs (#23161)
<!--Delete sections as needed -->

## Description

Added link to a Qualtrics survey for consolidated product-specific
feedback and a quicker option for the users from docs.
Fixed heading levels.
Removed roadmap.

https://deploy-preview-23161--docsdocker.netlify.app/offload/feedback/

## Related issues or tickets

UR-788
ENGDOCS-2834

## Reviews

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

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-25 12:01:24 -07: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
Craig Osterhout
9998976e24 offload: add feedback (#23074)
<!--Delete sections as needed -->

## Description

Add feedback section to Offload docs to guide users to the feedback
channels.

## Related issues or tickets

ENGDOCS-2834

## Reviews

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

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-11 08:38:39 -07:00
aevesdocker
5ad501891a cb clarify 2025-07-11 09:53:49 +01:00
Craig Osterhout
99449474a1 Merge pull request #23065 from craig-osterhout/remove-harmonia
harmonia: remove docs
2025-07-10 13:45:59 -07:00
Craig Osterhout
194745f522 offload: add initial docs (#22910)
<!--Delete sections as needed -->

## Description

Add initial Docker Offload docs

https://deploy-preview-22910--docsdocker.netlify.app/offload/

https://deploy-preview-22910--docsdocker.netlify.app/reference/cli/docker/offload/

https://deploy-preview-22910--docsdocker.netlify.app/desktop/setup/vm-vdi/

Minor changes
https://deploy-preview-22910--docsdocker.netlify.app/desktop/
https://deploy-preview-22910--docsdocker.netlify.app/
https://deploy-preview-22910--docsdocker.netlify.app/manuals/

Pending sign up page link.

## Related issues or tickets

ENGDOCS-2704

## Reviews

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

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

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-07-10 12:09:07 +02:00