Docker accounts refresh#25584
Conversation
…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>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
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.
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>
…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>
Keep a brief account-types pointer on the accounts index with links to Organizations and Administration, and document individual vs organization accounts on the organization overview with a link back to Accounts. Co-authored-by: Cursor <cursoragent@cursor.com>
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
The Docker accounts refresh is well-executed. Changes are clear, concise, and consistent with the documentation style guide. Tabbed layouts for create-account and sign-in flows are well-formed. Terminology is consistent across all updated pages. No broken links, missing redirects, AI-generated patterns, or markdown formatting issues were found in the changed code.
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
Clean documentation refresh. The tab restructuring for create/sign-in flows, terminology clarifications, and cross-links are well-executed. No high or medium severity issues found.
| ## Change your password | ||
|
|
||
| You can change your password by initiating a password reset via email. To change your password: | ||
| You can change your password by starting a password reset by email: |
There was a problem hiding this comment.
[LOW] Awkward double "by" phrasing
The sentence "You can change your password by starting a password reset by email:" uses "by" twice in quick succession, which reads awkwardly. Consider rephrasing to something like: "To change your password, start a password reset by email:" or "You can change your password with a password reset email:"
| - Docker ID: A unique username that identifies you. | ||
| - Email: How Docker contacts you for notifications and security-related | ||
| communications. | ||
| - Sign-in method: Email and password, Google, or GitHub. |
There was a problem hiding this comment.
| - Sign-in method: Email and password, Google, or GitHub. | |
| - Sign-in method: Email and password, [single sign-on (SSO)](/enterprise/security/single-sign-on.md), Google, or GitHub. |
| 1. Go to the [Docker sign-up page](https://app.docker.com/signup/) and enter a | ||
| unique, valid email address. | ||
| 1. Enter a username to use as your Docker ID. Once you create your Docker ID, | ||
| you can't reuse it if you deactivate this account. Your username: |
There was a problem hiding this comment.
| you can't reuse it if you deactivate this account. Your username: | |
| you can't change it or reuse it if you deactivate this account. Your username: |
| 1. Select **Authorize Docker** to let Docker access your social account | ||
| information. You will be re-routed to the sign-up page. | ||
| information. Docker redirects you to the sign-up page. | ||
| 1. Enter a username to use as your Docker ID. Your username: |
There was a problem hiding this comment.
We should probably have the same username disclaimers that we have on lines 44-45
| {{< /tab >}} | ||
| {{< /tabs >}} | ||
|
|
||
| ## Sign in to your account |
There was a problem hiding this comment.
i think we should consider removing this entire ## Sign in to your account section
| {{< /tab >}} | ||
| {{< /tabs >}} | ||
|
|
||
| ## Reset your password |
There was a problem hiding this comment.
Same as above, I don't think we need a docs section explaining the pw reset flow
gmondello
left a comment
gmondello
left a comment
There was a problem hiding this comment.
Left some comments but looks good to me
4 participants
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
To do: verify UI (separate PR)