V11.8 Docs by amyblais · Pull Request #8974 · mattermost/docs

amyblais · 2026-05-15T06:42:26Z

No specific review needed, just needs one more approval to be able to merge.

This PR will be merged on Tuesday, June 16th.

coderabbitai · 2026-05-15T06:42:33Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

This PR updates documentation: clarifies Report a Problem Default behavior and fixes its env var name, adds mobile-app log troubleshooting with the /mobile-logs command, expands deleted-message deletion/reporting details, tweaks a slash-command list entry, and bumps the Sphinx docs version to 11.8.

Changes

Documentation Updates

Layer / File(s)	Summary
Report a Problem configuration documentation `source/administration-guide/configure/site-configuration-settings.rst`	Updated the Default option to document license-based behaviour (licensed deployments open a support case by email; unlicensed deployments are directed to troubleshooting forums). Corrected the environment variable name from `MM_SUPPORTSETTINGS_REPORTAPROBLMEMAIL` to `MM_SUPPORTSETTINGS_REPORTAPROBLEMMAIL` in the setting metadata and the reference table.
Mobile app logs troubleshooting & push notifications `source/deployment-guide/mobile/mobile-troubleshooting.rst`	Added a new subsection describing the `/mobile-logs` command (`on`, `off`, `status`, optional `@username`), app-version and non-admin targeting notes (non-enumeration response and audit logging). Also adjusted `DeviceId` code markup in push-notification guidance.
Deleted messages & post deletion report `source/administration-guide/manage/admin/content-flagging.rst`	Replaced prior brief deletion bullets with a detailed deletion scope list and added a “Post deletion report” subsection describing per-step statuses, localization/delivery behaviour, and escalation steps referencing an attached `deletion_report_<post_id>.md`.
Slash commands list minor edit & Sphinx version bump `source/integrations-guide/built-in-slash-commands.rst`, `source/conf.py`	Adjusted the placement/markup of the `/logout` bullet under “More useful slash commands” (content unchanged). Updated Sphinx `version` and `release` comment values from `11.7` to `11.8`.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

mattermost/docs#8913: Also updates source/deployment-guide/mobile/mobile-troubleshooting.rst to cover the /mobile-logs command.
mattermost/docs#8845: Also updates Report a Problem documentation and renames MM_SUPPORTSETTINGS_REPORTAPROBLMEMAIL → MM_SUPPORTSETTINGS_REPORTAPROBLEMMAIL.
mattermost/docs#8934: Overlaps with the expanded “Deleted messages” documentation and the new “Post deletion report” content.

Suggested labels: 1: PM Review

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title 'V11.8 Docs' is vague and generic, referring only to the version number without describing the specific documentation changes being made.	Use a more descriptive title that summarizes the main changes, such as 'Add v11.8 documentation updates for Report a Problem, mobile logs, content flagging, and configuration' or similar.
Description check	❓ Inconclusive	No pull request description was provided by the author, making it impossible to assess relevance to the changeset.	Add a pull request description that explains the purpose of these documentation updates and how they relate to the v11.8 release.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ 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 v11.8-documentation

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.}

Copilot

Pull request overview

Updates the Sphinx documentation configuration to reflect the Mattermost v11.8 documentation version.

Changes:

Bumps the commented version value from 11.7 to 11.8 in source/conf.py.
Bumps the commented release value from 11.7 to 11.8 in source/conf.py.

github-actions · 2026-05-15T06:46:14Z

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

* MM-67771: Update Report a Problem docs to reflect email flow Update the "Default link" description to reflect the new behavior: licensed servers now open an email to Mattermost support, and free edition directs to the troubleshooting forums. Also fix typo in REPORTAPROBLMEMAIL env var name. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Update site-configuration-settings.rst --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com> Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@source/conf.py`:
- Around line 529-531: Uncomment the Sphinx version settings by removing the
comment markers so the variables version and release are assigned (i.e., change
the commented lines for version = '11.8' and release = '11.8' to active
assignments) in source/conf.py so Sphinx can substitute |version| and |release|
in the docs.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a570f205-7bcb-411a-9a9b-7f041d5976a9

📥 Commits

Reviewing files that changed from the base of the PR and between 84ccd00 and 328fc1e.

📒 Files selected for processing (2)

source/administration-guide/configure/site-configuration-settings.rst
source/conf.py

github-actions · 2026-05-18T09:09:03Z

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

github-actions · 2026-05-18T09:12:45Z

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

* docs: add /mobile-logs slash command Document the new /mobile-logs command introduced in mattermost/mattermost#35658, which toggles the attach_app_logs preference to enable attaching mobile app logs as a file in the Mattermost mobile client (v2.38+) for debugging. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs: refine /mobile-logs admonition and wording - Elevate security/audit note to .. important:: - Use bold instead of italics for the error message - Clarify the attachment applies to any message the user sends Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * address reviews * docs: refine mobile troubleshooting formatting * improve description --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

coderabbitai

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@source/deployment-guide/mobile/mobile-troubleshooting.rst`:
- Line 168: Standardize the session menu label wording on this page by choosing
one of the two variants and updating all occurrences to match; replace either
"View and Log Out of Active Sessions" or "View and Logout of Active Sessions" so
the label is consistent (ensure both the line around the DeviceId/Sessions
explanation and the earlier reference use the same string), and follow
Mattermost's standard UI label casing/spacing when making the change.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

Push a commit to this branch (recommended)
Create a new PR with the fixes

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c5f9c96c-384e-42aa-9b67-57184e0c79bf

📥 Commits

Reviewing files that changed from the base of the PR and between 328fc1e and 89c8271.

📒 Files selected for processing (2)

source/deployment-guide/mobile/mobile-troubleshooting.rst
source/integrations-guide/built-in-slash-commands.rst

✅ Files skipped from review due to trivial changes (1)

source/integrations-guide/built-in-slash-commands.rst

github-actions · 2026-05-19T07:40:57Z

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

github-actions · 2026-05-19T07:43:04Z

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

github-actions · 2026-05-20T10:03:07Z

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

github-actions · 2026-05-21T06:13:25Z

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

github-actions · 2026-05-21T10:47:48Z

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

github-actions · 2026-05-25T06:55:14Z

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

github-actions · 2026-05-27T06:21:34Z

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

github-actions · 2026-06-15T05:29:14Z

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

* MM-68718: Document Azure Blob Storage as a file storage backend (#8976) * Document Azure Blob Storage as a file storage backend Adds Azure Blob Storage to the File storage system reference: a new azureblob driver-name option and individual entries for the FileSettings.AzureStorageAccount, AzureContainer, AzurePathPrefix, AzureAccessKey, AzureEndpoint, AzureSSL, and AzureRequestTimeoutMilliseconds settings. Extends the dedicated export filestore list with the matching Export* variants. Calls out the restart-required behaviour when changing file storage settings so admins know Save in System Console isn't enough on its own. ------ AI assisted commit * Add walk-through page for configuring Azure Blob Storage Folds the full prereqs, Azure portal/CLI provisioning, System Console walk-through, Test Connection semantics, restart-required warning, verification, optional export backend, and troubleshooting sections into a dedicated configure/azure-blob-storage page. Wires the new page into the configuration-settings toctree and bullet list, and adds a seealso link from the File storage section of environment-configuration-settings so admins can find it from the reference page. ------ AI assisted commit * Document migrating existing files from Amazon S3 Adds a Migrate existing files from Amazon S3 section to the Azure Blob Storage walk-through. Covers the recommended trickle-then-cutover pattern (long rclone sync, short AzCopy maintenance window), the prerequisites for the migration host, phase-by-phase commands, verification queries (object count parity, sha256 spot-check), the rollback path, and caveats (S3 versioning, sync vs copy, prefix rewrites, cross-region cost, Storage Mover preview status). Updates the migration note under step 4 and the troubleshooting entry for missing pre-cutover files to cross-reference the new section. ------ AI assisted commit * Document AzureCloud and the updated AzureEndpoint semantics Adds the AzureCloud setting documentation (commercial/government/custom) to both the environment configuration reference and the Azure walkthrough, rewrites the AzureEndpoint entry to reflect its new role as the full Blob service URL valid only when AzureCloud is custom, and removes the stale note that said sovereign clouds aren't configured through the endpoint override. Adds ExportAzureCloud to the dedicated export filestore key list. ------ AI assisted commit * Document DefaultAzureCredential authentication mode Restructures Step 3 of the Azure Blob Storage walk-through to cover both shared-key and the new default_credential authentication mode. The default_credential subsection walks an admin through picking the identity source that matches the host (managed identity on Azure VM/App Service/AKS, workload identity, service principal, az login) and granting Storage Blob Data Contributor on the storage account. Updates Step 4 to describe the new "Azure authentication" dropdown in the System Console, including the conditional visibility of the Azure Storage account key field. Adds AuthorizationPermissionMismatch to the troubleshooting table and documents the propagation delay that follows a fresh role assignment. Adds FileSettings.AzureAuthMode to the environment-configuration reference and to the ExportAzure* list under the dedicated export filestore section. ------ AI assisted commit * Simplify the docs * Update source/administration-guide/configure/azure-blob-storage.rst Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Document Azure SAS support for presigned export downloads Add ExportAzurePresignExpiresSeconds to the dedicated export filestore key list, and generalize the presigned-download note so it reflects that exports can now be downloaded via an Azure Blob Storage SAS URL, not just an Amazon S3 presigned URL. ------ AI assisted commit * Address review comments * Add missing new line * Fix malformed quotes --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * docs: clarify ID attribute case sensitivity for AD/LDAP and SAML (#9020) Add notes to the AD/LDAP ID attribute, AD/LDAP Group ID attribute, and SAML ID attribute settings explaining that values are matched verbatim with no case normalization. Under PostgreSQL's default case-sensitive collation, a change in casing is treated as a new user or unlinked group, so the identity provider must return these attributes with consistent casing. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com> * docs: add Edit Attachments permission documentation Document the new Edit Attachments permission introduced in Mattermost v11.8.0, which controls whether users can add or remove file attachments when editing posts. Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Update authentication-configuration-settings.rst * Update authentication-configuration-settings.rst * Update authentication-configuration-settings.rst * Update authentication-configuration-settings.rst * Update azure-blob-storage.rst * Update azure-blob-storage.rst * Remove unintended configure file changes --------- Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Wayne Wollesen <50209602+ewwollesen@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com> Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>

github-actions · 2026-06-15T06:12:31Z

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

github-actions · 2026-06-15T06:15:49Z

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

* Remove CJK search feature flag mention now that it defaults to true (#9029) * Remove CJK search feature flag mention now that it defaults to true * Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8 * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Document v11.8 classification markings and banners Add an end-user Classification markings section to display-channel-banners.rst and an admin Classification Markings section to site-configuration-settings.rst, covering global and channel-level classification banners in the web and desktop apps. Classification markings are informational only and don't control access. Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> * Removing unintended commits --------- Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@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>

github-actions · 2026-06-15T09:26:48Z

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

github-actions · 2026-06-15T09:28:06Z

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

…9038) * Remove CJK search feature flag mention now that it defaults to true (#9029) * Remove CJK search feature flag mention now that it defaults to true * Clarify CJK search defaults to true on v11.9, flag-gated on v11.5-v11.8 * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Document plugin-provided metrics via standard /metrics endpoint Add documentation for the AggregatePluginMetrics feature flag (v11.8.0), which exposes plugin-provided Prometheus metrics through the standard Mattermost /metrics endpoint with a plugin_id label. Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> * Removing unintended commits --------- Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@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>

github-actions · 2026-06-15T16:31:59Z

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

Align the docs with the admin console rename from Site Statistics to System Statistics so navigation and delegated-admin guidance match the UI. Preserve the legacy reporting settings anchor so existing deep links continue to resolve. Made-with: Cursor Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>

github-actions · 2026-06-15T16:35:55Z

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

github-actions · 2026-06-15T16:36:15Z

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

github-actions · 2026-06-15T16:40:56Z

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

github-actions · 2026-06-15T16:48:52Z

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

github-actions · 2026-06-15T16:55:51Z

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

Update conf.py

53db6b0

Copilot AI review requested due to automatic review settings May 15, 2026 06:42

amyblais added this to the v11.8.0 milestone May 15, 2026

amyblais added the Work In Progress Not yet ready for review label May 15, 2026

Copilot started reviewing on behalf of amyblais May 15, 2026 06:43 View session

Copilot AI reviewed May 15, 2026

View reviewed changes

coderabbitai Bot requested changes May 18, 2026

View reviewed changes

Comment thread source/conf.py

Merge branch 'master' into v11.8-documentation

bec05d0

coderabbitai Bot approved these changes May 18, 2026

View reviewed changes

coderabbitai Bot requested changes May 19, 2026

View reviewed changes

Comment thread source/deployment-guide/mobile/mobile-troubleshooting.rst

Merge branch 'master' into v11.8-documentation

91d11f7

coderabbitai Bot approved these changes May 19, 2026

View reviewed changes

Merge branch 'master' into v11.8-documentation

3ebc52d

Merge branch 'master' into v11.8-documentation

e9ffec4

Merge branch 'master' into v11.8-documentation

aee36a1

Merge branch 'master' into v11.8-documentation

3b1a5de

Merge branch 'master' into v11.8-documentation

7a5c45f

Merge branch 'master' into v11.8-documentation

0e20fb8

Combs7th and others added 2 commits June 15, 2026 09:08

Update mattermost-v11-changelog.md

6578721

amyblais requested review from wiersgallak and removed request for saturninoabril June 15, 2026 06:22

Combs7th and others added 2 commits June 15, 2026 12:22

Update mattermost-v11-changelog.md

6551814

esarafianou approved these changes Jun 15, 2026

View reviewed changes

amyblais removed request for Combs7th, NARSimoes and wiersgallak June 15, 2026 15:41

amyblais added 3: Reviews Complete All reviewers have approved the pull request and removed 2: Editor Review Requires review by an editor labels Jun 15, 2026

marianunez and others added 2 commits June 15, 2026 19:32

Merge branch 'master' into v11.8-documentation

6539036

Update mattermost-v11-changelog.md

e9f9ca1

Merge branch 'master' into v11.8-documentation

7a12a8a

Merge branch 'master' into v11.8-documentation

a8f2f62

Conversation

amyblais commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

❌ Failed checks (2 inconclusive)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

github-actions Bot commented May 15, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented May 18, 2026

Uh oh!

github-actions Bot commented May 18, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented May 19, 2026

Uh oh!

github-actions Bot commented May 19, 2026

Uh oh!

github-actions Bot commented May 20, 2026

Uh oh!

github-actions Bot commented May 21, 2026

Uh oh!

github-actions Bot commented May 21, 2026

Uh oh!

github-actions Bot commented May 25, 2026

Uh oh!

github-actions Bot commented May 27, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

github-actions Bot commented Jun 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

amyblais commented May 15, 2026 •

edited

Loading

coderabbitai Bot commented May 15, 2026 •

edited

Loading