Skip to content

docs(auth): Clarify Google SSO username/email sync behavior#8832

Merged
esethna merged 5 commits intov11.6-documentationfrom
claude/issue-8831-20260324-2330
Apr 6, 2026
Merged

docs(auth): Clarify Google SSO username/email sync behavior#8832
esethna merged 5 commits intov11.6-documentationfrom
claude/issue-8831-20260324-2330

Conversation

@Combs7th
Copy link
Copy Markdown
Contributor

Adds a sentence to the existing user-attribute note in the Google SSO setup guide clarifying that username and email address changes made in Google Workspace are not automatically synced to Mattermost.

Aligns with mattermost/mattermost#34475.

Closes #8831

Generated with Claude Code

amyblais and others added 2 commits March 24, 2026 18:34
* Update mattermost-desktop-releases.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md
Username and email address changes made in Google Workspace are not
automatically synced to Mattermost. Adds a note to the existing
user-attribute warning in the Google SSO setup guide to prevent
readers from incorrectly inferring that the IdP is an automatic sync
source. Aligns with mattermost/mattermost#34475.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
@Combs7th Combs7th requested a review from devinbinnie March 24, 2026 23:36
@Combs7th Combs7th changed the base branch from master to v11.6-documentation March 24, 2026 23:36
@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor Guidance labels Mar 24, 2026
@Combs7th Combs7th added this to the v11.6.0 milestone Mar 24, 2026
@Combs7th
Copy link
Copy Markdown
Contributor Author

@devinbinnie - Do the above doc updates look accurate to you here?

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 24, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a236f2bd-4e78-40fb-9b34-de63bc60fc09

📥 Commits

Reviewing files that changed from the base of the PR and between 8162094 and 78f6fcc.

📒 Files selected for processing (1)
  • source/administration-guide/onboard/sso-google.rst

📝 Walkthrough

Walkthrough

A documentation update was made to the Google SSO onboarding guide to clarify that changes to usernames and email addresses in Google Workspace are not automatically synchronized to Mattermost.

Changes

Cohort / File(s) Summary
Google SSO Documentation
source/administration-guide/onboard/sso-google.rst
Added a clarifying note documenting that username and email address modifications in Google Workspace are not automatically synced to Mattermost for SSO users.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the primary change: adding documentation clarification about Google SSO username/email sync behavior.
Description check ✅ Passed The description is directly related to the changeset, explaining that a clarifying sentence was added to the Google SSO setup guide regarding username and email sync behavior.
Linked Issues check ✅ Passed The PR addresses the core objective from #8831 by adding a clarifying note about Google SSO username/email sync behavior to the documentation, aligning with the engineering PR #34475.
Out of Scope Changes check ✅ Passed The changeset is limited to adding a single note about Google SSO sync behaviour in the appropriate documentation file, with no unrelated modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/issue-8831-20260324-2330

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 78f6fcc

Copy link
Copy Markdown
Member

@devinbinnie devinbinnie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep, changes look good, just need to revert the extra stuff in here.

Comment thread source/product-overview/desktop-app-changelog.md Outdated
@Combs7th
Copy link
Copy Markdown
Contributor Author

Thanks @devinbinnie! Unintended changes have been reverted. @esethna - This one should be ready to go.

@Combs7th Combs7th requested a review from esethna March 31, 2026 03:24
@github-actions
Copy link
Copy Markdown
Contributor

Newest code from mattermost has been published to preview environment for Git SHA 4289754

Comment thread source/product-overview/desktop-app-changelog.md Outdated
Comment thread source/product-overview/mattermost-desktop-releases.md Outdated
@Combs7th
Copy link
Copy Markdown
Contributor Author

Combs7th commented Apr 6, 2026

Thanks @devinbinnie! Unintended changes have been reverted. @esethna - This one should be ready to go.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 3085c26

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

Newest code from mattermost has been published to preview environment for Git SHA 376254d

@esethna esethna merged commit 1034516 into v11.6-documentation Apr 6, 2026
5 checks passed
@esethna esethna deleted the claude/issue-8831-20260324-2330 branch April 6, 2026 22:04
@amyblais amyblais removed the 2: Editor Review Requires review by an editor label Apr 7, 2026
@coderabbitai coderabbitai bot mentioned this pull request Apr 13, 2026
amyblais added a commit that referenced this pull request Apr 16, 2026
* Update conf.py

* [MM-65701] Document 7zip file blocking in file content search (#8836)

Adds notes to end-user search docs and admin config docs clarifying
that 7zip (.7z) files are not supported for file content search and
are skipped for security reasons. Only standard ZIP files are supported
when ZIP file search is enabled.

Ref: mattermost/mattermost#34983

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add docs for preferred_username claim support in OpenID Connect (#8838)

Adds Use preferred username setting documentation to each OpenID
Connect provider section (GitLab, Google, Entra ID, OpenID Connect
other) in the authentication configuration settings reference, and a
corresponding note in the OpenID Connect SSO setup guide.

Closes #8835

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* docs(auth): Clarify Google SSO username/email sync behavior (#8832)

* Desktop v5.13.5 docs (#8828)

* Update mattermost-desktop-releases.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* docs(auth): clarify Google SSO username/email sync behavior

Username and email address changes made in Google Workspace are not
automatically synced to Mattermost. Adds a note to the existing
user-attribute warning in the Google SSO setup guide to prevent
readers from incorrectly inferring that the IdP is an automatic sync
source. Aligns with mattermost/mattermost#34475.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* Update mattermost-desktop-releases.md

---------

Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update mattermost-desktop-releases.md

* Update desktop-app-changelog.md

* Add four newly sanitized fields to Support Packet documentation (#8874)

* Improve PostgreSQL database setup discoverability in search (#8865)

* Improve PostgreSQL database setup page discoverability in search

Searching for "postgres" or "postgres setup" in the docs didn't surface the
database preparation instructions on the preparations page. Renamed the section
heading, added search metadata, and included PostgreSQL in the intro paragraph
to improve Sphinx search ranking.

Also fixes a sphinx-autobuild rebuild loop caused by generated agent docs
being rewritten during each build cycle.

Closes #8864

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Address CodeRabbit review feedback

- Use double quotes for --ignore glob in Makefile for Windows cmd.exe
  compatibility
- Add legacy anchor label to preserve existing deep links to
  #database-preparation after heading rename

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs: add four newly sanitized fields to Support Packet documentation

From Mattermost v11.6.0 (mattermost/mattermost#35346), the following
fields are now automatically redacted during Support Packet generation:
- FileSettings.ExportAmazonS3SecretAccessKey
- ElasticsearchSettings.ClientKey
- ServiceSettings.GoogleDeveloperKey
- ServiceSettings.GiphySdkKey

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update Makefile

* Update preparations.rst

---------

Co-authored-by: Stuart Doherty <stu.doherty@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Add popout window documentation for search results (#8868)

* Add popout window documentation for search results (v11.6)

Documents the new Search RHS popout feature introduced in Mattermost v11.6,
covering: opening search results in a popout window, query preservation,
thread navigation within the popout, back button behavior, and Jump
opening the source channel in the main window.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update search-for-messages.rst

* Update search-for-messages.rst

---------

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>

* Mobile Feat: AI rewrite (#8872)

* Improve PostgreSQL database setup discoverability in search (#8865)

* Improve PostgreSQL database setup page discoverability in search

Searching for "postgres" or "postgres setup" in the docs didn't surface the
database preparation instructions on the preparations page. Renamed the section
heading, added search metadata, and included PostgreSQL in the intro paragraph
to improve Sphinx search ranking.

Also fixes a sphinx-autobuild rebuild loop caused by generated agent docs
being rewritten during each build cycle.

Closes #8864

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Address CodeRabbit review feedback

- Use double quotes for --ignore glob in Makefile for Windows cmd.exe
  compatibility
- Add legacy anchor label to preserve existing deep links to
  #database-preparation after heading rename

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs: expand mobile AI rewrite workflow in send-messages.rst

Replace the one-liner Mobile tab under 'Rewrite messages with AI' with
a full step-by-step workflow mirroring the existing Web/Desktop section,
covering: opening rewrite from the composer, selecting an agent, choosing
rewrite options (including custom prompt), the processing state, and
reviewing/sending the result.

Closes #8871

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update preparations.rst

* Update Makefile

* Simplify

---------

Co-authored-by: Stuart Doherty <stu.doherty@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>

* Rename Content Flagging to Data Spillage Handling (#8870)

* Improve PostgreSQL database setup discoverability in search (#8865)

* Improve PostgreSQL database setup page discoverability in search

Searching for "postgres" or "postgres setup" in the docs didn't surface the
database preparation instructions on the preparations page. Renamed the section
heading, added search metadata, and included PostgreSQL in the intro paragraph
to improve Sphinx search ranking.

Also fixes a sphinx-autobuild rebuild loop caused by generated agent docs
being rewritten during each build cycle.

Closes #8864

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Address CodeRabbit review feedback

- Use double quotes for --ignore glob in Makefile for Windows cmd.exe
  compatibility
- Add legacy anchor label to preserve existing deep links to
  #database-preparation after heading rename

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* docs: rename Content Flagging to Data Spillage Handling (v11.6.0)

Update user-visible and admin-visible terminology throughout the
Content Flagging docs to reflect the v11.6.0 rename:

- Rename page title and all feature-name references from
  'Content Flagging' to 'Data Spillage Handling'
- Update System Console navigation path to
  'System Console > Site Configuration > Data Spillage Handling'
- Replace 'flag/flagged' with 'quarantine/quarantined' where the
  product UI now uses that wording
- Replace 'content-review bot' with 'Data Spillage Bot' in all
  user-facing notification and moderation queue descriptions
- Update 'Flag message' menu action to 'Quarantine for Review'

Internal RST cross-reference labels and API/config identifiers
left unchanged per scope constraints.

Closes #8869

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update preparations.rst

* Update Makefile

* Update Data Spillage Handling reasons to new default categories

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

---------

Co-authored-by: Stuart Doherty <stu.doherty@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Allow System Admins to view and update User AuthData and Username in System Console (#8834)

* Desktop v5.13.5 docs (#8828)

* Update mattermost-desktop-releases.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* Update desktop-app-changelog.md

* docs: add System Admin ability to update username and AuthData in System Console

Reflects the new capability from mattermost/mattermost#33550 where System
Admins can view and update user AuthData and username directly in the System
Console user detail workflow.

Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update user-management-configuration-settings.rst

* Update desktop-app-changelog.md

* Update mattermost-desktop-releases.md

---------

Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>

* Update desktop-app-changelog.md

* Update mattermost-desktop-releases.md

* v11.6 Changelog (#8821)

* Prepare v11.6 feature release docs (April 16, 2026)

Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>

* Update important-upgrade-notes.rst

* Update deprecated-features.rst

* Update release-policy.md

* Update mattermost-v11-changelog.md

* Update software-hardware-requirements.rst

* Update open-source-components.rst

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

* Update ui-ada-changelog.rst

* Update mattermost-v11-changelog.md

* Update mattermost-desktop-releases.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update source/product-overview/mattermost-v11-changelog.md

Co-authored-by: Doug Lauder <wiggin77@warpmail.net>

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

* Update mattermost-v11-changelog.md

* Update important-upgrade-notes.rst

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

* Update mattermost-v11-changelog.md

* Update ui-ada-changelog.rst

---------

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Co-authored-by: Doug Lauder <wiggin77@warpmail.net>

---------

Co-authored-by: Christopher Poile <cpoile@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Combs7th <147677911+Combs7th@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Co-authored-by: Stuart Doherty <stu.doherty@gmail.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>
Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Co-authored-by: Doug Lauder <wiggin77@warpmail.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1: Dev Review Requires review by a core commiter Guidance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(auth): Clarify Google SSO username/email sync behavior

4 participants