Skip to content

Docker accounts refresh#25584

Draft
akristen wants to merge 5 commits into
docker:mainfrom
akristen:docker-acounts
Draft

Docker accounts refresh#25584
akristen wants to merge 5 commits into
docker:mainfrom
akristen:docker-acounts

Conversation

@akristen

Copy link
Copy Markdown
Contributor

Summary

Refreshes the Docker accounts section to clarify what a Docker account is, how Docker IDs / email / sign-in methods relate, and how individual accounts differ from organizations. Also updates create, manage, deactivate, and FAQ pages for terminology consistency, clearer verification/sign-in flows (tabs), and cross-links.

Changes

  • Expand accounts overview with identity and individual vs organization concepts
  • Restructure create-account and sign-in steps into tabs; tighten OTP/verification copy
  • Refresh manage, deactivate, and FAQ pages (titles, linkTitles, wording, What's next)

To do: verify UI

  • Confirm create-account Email / Google or GitHub tabs render and switch correctly
  • Confirm sign-in tabs (Email or Docker ID / Google or GitHub / CLI) render correctly
  • Spot-check accounts overview grid cards and links
  • Spot-check manage, deactivate, and FAQ pages for formatting and cross-links
  • Confirm sidebar linkTitles (Create, Manage, FAQs) look right in nav

…tes.

Clarify individual vs organization accounts, refresh create/manage/deactivate/FAQ pages, and align terminology away from personal-account wording.

Co-authored-by: Cursor <cursoragent@cursor.com>
@akristen akristen self-assigned this Jul 16, 2026
@akristen akristen added the area/accounts Relates to Docker accounts label Jul 16, 2026
@netlify

netlify Bot commented Jul 16, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

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

@docker-agent docker-agent 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.

Assessment: 🟡 NEEDS ATTENTION

Documentation refresh for the Docker accounts section. The changes are well-structured overall: cleaner prose, improved list formatting, correct tab shortcodes, and useful cross-links in "What's next" sections. No vendored/generated files, no missing redirect aliases.

One medium-severity clarity issue: the new text on the overview page states Docker doesn't support linking multiple sign-in methods, but the manage-account page has a "Manage connected accounts" section with a Disconnect flow that implies otherwise. The distinction between "you can't add a second sign-in method" and "you can disconnect an OAuth provider you signed up with" is real but needs to be made explicit.

Comment thread content/manuals/accounts/_index.md Outdated
akristen and others added 3 commits July 16, 2026 13:07
Tighten account identity framing, surface Organization overview in the grid, and align create-account linking language with email-plus-one-social behavior.

Co-authored-by: Cursor <cursoragent@cursor.com>
Spell out that disconnecting Google or GitHub removes OAuth access without changing the Docker ID or adding another sign-in method.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep the connected-accounts clarification while putting back the sections dropped in the prior commit.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions github-actions Bot added the area/admin Relates to Docker Admin label Jul 16, 2026
…ions.

Rely on the overview grid for navigation instead of repeating next-step lists on create, deactivate, and FAQ pages.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/accounts Relates to Docker accounts area/admin Relates to Docker Admin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants