Skip to content

V11.9 Docs#9043

Open
amyblais wants to merge 12 commits into
masterfrom
v11.9-documentation
Open

V11.9 Docs#9043
amyblais wants to merge 12 commits into
masterfrom
v11.9-documentation

Conversation

@amyblais

Copy link
Copy Markdown
Member

No description provided.

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

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: af0f4e27-3b9a-4580-b110-ef52eb968458

📥 Commits

Reviewing files that changed from the base of the PR and between 0ee7d27 and f25be70.

📒 Files selected for processing (1)
  • source/administration-guide/scale/performance-monitoring-metrics.rst
✅ Files skipped from review due to trivial changes (1)
  • source/administration-guide/scale/performance-monitoring-metrics.rst

📝 Walkthrough

Walkthrough

The PR updates commented version/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#9050: This PR updates the same Calls plugin DM video documentation in the configuration guide and the end-user FAQ.
🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title is related to the changeset, but it is too generic to describe the actual documentation updates. Use a more specific title that names the main documentation change, such as v11.9 docs for video calls and attribute masking updates.
Description check ❓ Inconclusive No description was provided, so there is no meaningful summary to evaluate. Add a brief description that mentions the main documentation areas updated in this pull request.
✅ 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.
✨ 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>
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

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

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

Labels

Work In Progress Not yet ready for review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants