Skip to content

V11.8 Docs#8974

Open
amyblais wants to merge 30 commits into
masterfrom
v11.8-documentation
Open

V11.8 Docs#8974
amyblais wants to merge 30 commits into
masterfrom
v11.8-documentation

Conversation

@amyblais

@amyblais amyblais commented May 15, 2026

Copy link
Copy Markdown
Member

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

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

Copilot AI review requested due to automatic review settings May 15, 2026 06:42
@amyblais amyblais added this to the v11.8.0 milestone May 15, 2026
@coderabbitai

coderabbitai Bot commented May 15, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

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

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

Copilot AI 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.

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

Copy link
Copy Markdown
Contributor

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 coderabbitai Bot 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.

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

Comment thread source/conf.py
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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 coderabbitai Bot 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.

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

Comment thread source/deployment-guide/mobile/mobile-troubleshooting.rst
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

changelog-automation-docs Bot and others added 2 commits June 12, 2026 08:49
* docs: add changelog for v11.8.0

* 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 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: Jesse Hallam <jesse.hallam@gmail.com>

* 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 mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Add attribute value masking information to 11.8.0 changelog docs (#8999)

* 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: Maria A Nunez <maria.nunez@mattermost.com>

* 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 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

---------

Co-authored-by: Changelog Bot <changelog-bot@mattermost.com>
Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>
Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Pablo Vélez <pablovv2012@gmail.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>
* Update docs for v11.8 (June 16th) release

- Add v11.8 row to server releases table (released 2026-06-16, support ends 2026-09-15)
- Bump latest release download URLs to 11.8.0 in deploy-rhel.rst and deploy-tar.rst
- Add v11.8 to compatibility list for Desktop App v6.2 (ESR)
- Update release policy gantt chart: mark v11.5 as done, add v11.9
- Add Mattermost Enterprise Edition v11.8.0 entry to open source components

Refs #8981

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

* Update mattermost-desktop-releases.md

* Update open-source-components.rst

* Update ui-ada-changelog.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update source/product-overview/ui-ada-changelog.rst

Co-authored-by: Guillermo Vayá <guivaya@gmail.com>

* Update important-upgrade-notes.rst

* 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: Guillermo Vayá <guivaya@gmail.com>
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais amyblais requested a review from Combs7th June 12, 2026 05:59
@amyblais amyblais added Do Not Merge Should not be merged until this label is removed 2: Editor Review Requires review by an editor Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) and removed Work In Progress Not yet ready for review labels Jun 12, 2026
@amyblais amyblais requested a review from NARSimoes June 12, 2026 05:59
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais amyblais requested a review from saturninoabril June 15, 2026 05:25
@github-actions

Copy link
Copy Markdown
Contributor

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

Combs7th and others added 2 commits June 15, 2026 09:08
* 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

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais 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
* 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

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

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

Labels

2: Editor Review Requires review by an editor Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) Do Not Merge Should not be merged until this label is removed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants