Skip to content

docs(admin): freshness pass on organization members page - #25669

Open
akristen wants to merge 6 commits into
docker:mainfrom
akristen:export-email-async
Open

docs(admin): freshness pass on organization members page#25669
akristen wants to merge 6 commits into
docker:mainfrom
akristen:export-email-async

Conversation

@akristen

@akristen akristen commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

This updates documentation for csv exports between organizations and companies. For organizations, csv exports are async : you download and a csv file is sent to your email. Company still downloads to your browser.

PR also does freshness pass across both docs, aligning verbiage on how we refer to users (that is, not referring to them as users and defaulting to Docker Home language of invitees or members)

Refresh members.md for Docker Home: tab invite methods, async CSV
export email, remove-from-org steps, and clearer invitation/seat
guidance. Retarget the SSO FAQ link to the org-removal section.

Co-authored-by: Cursor <cursoragent@cursor.com>
@akristen
akristen requested a review from yarabarla July 29, 2026 13:59
@akristen akristen self-assigned this Jul 29, 2026
@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

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

@github-actions github-actions Bot added the area/admin Relates to Docker Admin label Jul 29, 2026

@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: 🟢 APPROVE

Clean freshness pass — prose tightened, AI-isms removed, UI terminology corrected, and the new tab layout improves scannability. The SSO FAQ anchor is updated consistently. No redirects are needed (page URL unchanged). One minor nit below.

Comment thread content/manuals/admin/organization/manage/members.md Outdated
docker-agent

This comment was marked as resolved.

Comment thread content/manuals/admin/organization/manage/members.md Outdated
akristen and others added 2 commits July 30, 2026 09:19
Address review feedback: drop Team/Business restriction, keep
owner-only scope, wrap long prose, and restore trailing newline.

Co-authored-by: Cursor <cursoragent@cursor.com>
Move company CSV fields and a browser-download export procedure to
company/manage.md. Keep org export async-via-email with an email
download step, and org-only CSV fields on members.md.

Co-authored-by: Cursor <cursoragent@cursor.com>
@akristen
akristen marked this pull request as ready for review July 30, 2026 16:13
@akristen
akristen requested a review from craig-osterhout July 30, 2026 16:13
docker-agent

This comment was marked as resolved.

docker-agent

This comment was marked as resolved.

akristen and others added 3 commits August 4, 2026 08:06
Org and company export docs listed incomplete or outdated CSV columns.
Nest corrected field lists in CSV fields accordions under the download steps.

Co-authored-by: Cursor <cursoragent@cursor.com>
Refresh both pages for Docker Home terminology: members and invitees,
correct CSV export fields in accordions, tighten redundant invitee copy,
and add Next steps.

Co-authored-by: Cursor <cursoragent@cursor.com>
@akristen
akristen requested review from aevesdocker and removed request for craig-osterhout August 4, 2026 13:28

@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: 🟢 APPROVE

No significant issues found. The freshness pass correctly aligns terminology (members/invitees), accurately distinguishes the async email-based CSV export for organizations from the synchronous browser download for companies, and the prose reads cleanly against the Docker style guide.

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

Labels

area/admin Relates to Docker Admin

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants