Skip to content

V11.9 Docs#9043

Merged
amyblais merged 25 commits into
masterfrom
v11.9-documentation
Jul 16, 2026
Merged

V11.9 Docs#9043
amyblais merged 25 commits into
masterfrom
v11.9-documentation

Conversation

@amyblais

@amyblais amyblais commented Jun 16, 2026

Copy link
Copy Markdown
Member

This just needs one more approval to be able to merge on Thursday, July 16th.

Copilot AI review requested due to automatic review settings June 16, 2026 06:05
@amyblais amyblais added the Work In Progress Not yet ready for review label Jun 16, 2026
@amyblais amyblais added this to the v11.9.0 milestone Jun 16, 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 documentation build configuration to reflect the v11.9 documentation version in the Sphinx config, aligning the repo metadata with the intended release.

Changes:

  • Updated the commented version value from 11.8 to 11.9.
  • Updated the commented release value from 11.8 to 11.9.

@coderabbitai

coderabbitai Bot commented Jun 16, 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

The PR updates commented version and release values in source/conf.py, adds ABAC documentation for attribute access modes and value masking, adds Calls plugin DM video configuration and FAQ documentation, and adds a new cluster metrics entry.

Changes

Documentation Version Bump

Layer / File(s) Summary
Commented version/release bump in conf.py
source/conf.py
The commented version and release lines are changed from 11.8 to 11.9.

ABAC Attribute Value Masking Documentation

Layer / File(s) Summary
Attribute access modes definition
source/administration-guide/manage/admin/user-attributes.rst
A new section documents per-attribute access modes (public, shared_only, source_only), plugin-only configuration through the Property Fields API, and masking behaviour in policy editors.
Masking behaviour in policy and channel access editors
source/administration-guide/manage/admin/abac-system-wide-policies.rst, source/administration-guide/manage/admin/abac-channel-access-rules.rst
The system-wide policies page adds an "Attribute value masking" subsection covering masked values as --------, read-only rows, disabled Test/Delete actions, unchanged enforcement, and Enterprise Advanced / AttributeValueMasking requirements; the channel access rules page adds the same masking note for affected rows.

Calls Plugin DM Video Support

Layer / File(s) Summary
Calls plugin video configuration setting
source/administration-guide/configure/plugins-configuration-settings.rst
A new experimental enable-pluginsvideo setting is added with its System Console location, config.json path, environment variable, DM video enable/disable behaviour, recording limits, and rtcd version guidance.
Video support FAQ update
source/end-user-guide/collaborate/make-calls.rst
The "Is video supported?" FAQ answer now describes experimental DM video support on desktop and web, default-disabled behaviour, plugin-setting enablement, mobile limitations, and recording exclusions.

Cluster Metrics Documentation

Layer / File(s) Summary
Cluster metric documentation
source/administration-guide/scale/performance-monitoring-metrics.rst
A new mattermost_cluster_reliable_fallback_tcp cluster metric entry is added, describing the UDP-to-TCP fallback histogram and its expected range and usage.

Estimated code review effort: 2 (Simple) | ~12 minutes

Possibly related PRs

  • mattermost/docs#8923: Updates the same ABAC documentation areas around channel access and policy semantics.
  • mattermost/docs#9050: Updates the same Calls plugin DM video documentation in the configuration guide and end-user FAQ.
  • mattermost/docs#9068: Modifies the same cluster metrics documentation area for mattermost_cluster_reliable_fallback_tcp.

Suggested labels: 1: Dev Review

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description only mentions approval timing and does not describe any of the documentation changes. Replace it with a brief summary of the docs updates, such as ABAC masking, Calls video support, and v11.9 documentation refreshes.
✅ Passed checks (4 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.
Title check ✅ Passed The title is broad but still accurately describes this as a v11.9 documentation update.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch v11.9-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.

@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`:
- Line 529: The version and release configuration variables are currently
commented out, which prevents Sphinx from applying the version bump to '11.9'.
This breaks the sitemap extension's dependency on app.builder.config.version for
generating version-aware URLs. Uncomment both the version and release variable
assignments (currently prefixed with #) to activate the version configuration so
Sphinx will properly use the specified version value.
🪄 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: e4b31403-7a15-4a2c-b76b-b5a9ef6de6aa

📥 Commits

Reviewing files that changed from the base of the PR and between 7451869 and 95a735e.

📒 Files selected for processing (1)
  • 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 95a735e

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

* MM-68992 - add attribute value masking documentation

* add details about access mode

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

🧹 Nitpick comments (1)
source/administration-guide/manage/admin/abac-system-wide-policies.rst (1)

133-152: 🧹 Nitpick | 🔵 Trivial | ⚡ Quick win

Elevate feature flag requirement to an explicit admonition for consistency and clarity.

The AttributeValueMasking feature flag requirement is stated inline at line 152, whereas the PermissionPolicies feature flag requirement (line 80) is documented in a dedicated .. note:: admonition. Since both are prerequisites that materially affect whether the feature functions, and the masking feature controls visibility of sensitive attribute values, this requirement should receive the same prominent treatment.

Proposed structure: Replace line 152 with an `.. important::` admonition
 **To edit a masked rule**, ask the policy owner or another System Admin who holds the relevant attribute values to make the change.

-This behavior applies to both the table editor and the CEL editor, and also to Team Admin and Channel Admin policy editors in Team Settings and Channel Settings. Requires Enterprise Advanced license and the ``AttributeValueMasking`` feature flag.
+This behavior applies to both the table editor and the CEL editor, and also to Team Admin and Channel Admin policy editors in Team Settings and Channel Settings.
+
+.. important::
+
+  Attribute value masking requires a Mattermost Enterprise Advanced license and the ``AttributeValueMasking`` feature flag to be enabled. See the Mattermost developer documentation for details on `enabling feature flags in a self-hosted deployment <https://developers.mattermost.com/contribute/more-info/server/feature-flags/#self-hosted-and-local-development>`_. Mattermost Cloud customers can request this feature flag be enabled by contacting their Mattermost Account Manager or by `creating a support ticket <https://support.mattermost.com/hc/en-us/requests/new?ticket_form_id=11184911962004>`_.

This approach:

  • Matches the style and link pattern already established in the file (lines 80–82)
  • Ensures admins understand both prerequisites before deploying this security feature
  • Elevates feature flag visibility to match the importance of the security feature it gates
🤖 Prompt for 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.

In `@source/administration-guide/manage/admin/abac-system-wide-policies.rst`
around lines 133 - 152, The AttributeValueMasking feature flag requirement is
currently stated inline at the end of the "Attribute value masking" section,
whereas the PermissionPolicies feature flag requirement uses a dedicated note
admonition for consistency. Replace the inline feature flag text at line 152
with a dedicated `.. important::` admonition that matches the style and link
pattern of the existing note block (lines 80-82), ensuring both prerequisites
receive equal prominence and that admins understand the feature flag requirement
is a prerequisite for the masking feature to function.

Source: Coding guidelines

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

Nitpick comments:
In `@source/administration-guide/manage/admin/abac-system-wide-policies.rst`:
- Around line 133-152: The AttributeValueMasking feature flag requirement is
currently stated inline at the end of the "Attribute value masking" section,
whereas the PermissionPolicies feature flag requirement uses a dedicated note
admonition for consistency. Replace the inline feature flag text at line 152
with a dedicated `.. important::` admonition that matches the style and link
pattern of the existing note block (lines 80-82), ensuring both prerequisites
receive equal prominence and that admins understand the feature flag requirement
is a prerequisite for the masking feature to function.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 57ca31c7-a398-48e6-a6b3-aff4670624b3

📥 Commits

Reviewing files that changed from the base of the PR and between 95a735e and 094da26.

📒 Files selected for processing (3)
  • source/administration-guide/manage/admin/abac-channel-access-rules.rst
  • source/administration-guide/manage/admin/abac-system-wide-policies.rst
  • source/administration-guide/manage/admin/user-attributes.rst
✅ Files skipped from review due to trivial changes (1)
  • source/administration-guide/manage/admin/abac-channel-access-rules.rst

@github-actions

Copy link
Copy Markdown
Contributor

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

* Document experimental video calls in DMs (Calls v1.12.0)

* Note external RTCD v1.2.2+ requirement for DM video calls
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

…cp (#9068)

* Document mattermost_cluster_reliable_fallback_tcp

* Update source/administration-guide/scale/performance-monitoring-metrics.rst

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

---------

Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>
* Add v11.9 release docs scaffolding

Mechanical version scaffolding for the v11.9 (2026-07-16) feature release:
- Add v11.9 row to the server Latest releases table
- Bump latest-release download to 11.9.0 in deploy-rhel and deploy-tar
- Add v11.9.0 server entry to open source components
- Add v11.9 to the Desktop App v6.2 "Compatible with" list

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

* Update open-source-components.rst

* Update ui-ada-changelog.rst

* Update release-policy.md

* 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 important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* Update ui-ada-changelog.rst

* Update important-upgrade-notes.rst

* Update ui-ada-changelog.rst

* Resolve conflict in deploy-rhel.rst

* Resolve conflict in deploy-tar.rst

* Resolve conflict in mattermost-server-releases.md

* Update important-upgrade-notes.rst

* Update important-upgrade-notes.rst

* MM-69392 - DCR changes upgrade notes (#9089)

---------

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

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@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 Jul 13, 2026
@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais
amyblais requested review from esarafianou and removed request for NARSimoes July 14, 2026 06:47
@amyblais amyblais added 3: Reviews Complete All reviewers have approved the pull request Do Not Merge Should not be merged until this label is removed Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) and removed 2: Editor Review Requires review by an editor Do Not Merge Should not be merged until this label is removed Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) labels Jul 15, 2026
@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais
amyblais merged commit 9ea246c into master Jul 16, 2026
5 checks passed
@amyblais amyblais removed the 3: Reviews Complete All reviewers have approved the pull request label Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants