Skip to content

V11.9 Docs#9043

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

V11.9 Docs#9043
amyblais wants to merge 7 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: 305c454f-8eff-4cd3-a8cb-f662672e2b29

📥 Commits

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

📒 Files selected for processing (2)
  • source/administration-guide/configure/plugins-configuration-settings.rst
  • source/end-user-guide/collaborate/make-calls.rst

📝 Walkthrough

Walkthrough

Commented version and release values in source/conf.py are updated from 11.8 to 11.9. Three ABAC administration documentation files are expanded to describe attribute value masking: a new "Attribute access modes" section explains per-attribute access control via plugins, and new masking notes detail UI behaviour when admins lack referenced attribute values across policy and channel rule editors. Documentation for a new experimental Calls plugin video setting is added, specifying configuration paths, rtcd deployment requirements, and corresponding FAQ updates explaining experimental DM video support with availability and limitation details.

Changes

Documentation Version Bump

Layer / File(s) Summary
Commented version/release bump
source/conf.py
The commented # version and # release configuration lines are updated 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
New section documents that system user attributes each have an access mode (public, shared_only, or source_only) that controls how attribute values display in admin policy editors; notes that access modes are configured only via plugin using the Property Fields API, not in the System Console.
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
New "Attribute value masking" subsection in system-wide-policies.rst documents that admins cannot see attribute values they do not personally hold for rules referencing shared_only or source_only attributes; describes display as --------, read-only row behaviour, and disabled Test/Delete actions; clarifies that enforcement is unchanged. Corresponding note added to channel-access-rules.rst documenting identical masking behaviour for channel access rules.

Calls Plugin DM Video Support

Layer / File(s) Summary
Calls plugin video configuration setting
source/administration-guide/configure/plugins-configuration-settings.rst
New experimental enable-pluginsvideo setting enables or disables DM video calls; documents System Console location, config.json path, environment variable, and enable/disable semantics (desktop/web-only, recording exclusions). Includes note specifying minimum rtcd version requirement (v1.2.2+) for RTCD-offload deployments and recommends version alignment with the Calls plugin release.
Video support FAQ update
source/end-user-guide/collaborate/make-calls.rst
Updated "Is video supported?" FAQ answer replaces generic statement with versioned description of experimental video support for DM calls on desktop and web starting from Mattermost Calls plugin v1.12.0, disabled by default and enabled via the experimental plugin configuration setting. Specifies DM-only scope, no mobile support, and that video is excluded from call recordings.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • mattermost/docs#9050: The main PR's documentation updates to the Calls plugin DM video setting and the "Is video supported?" FAQ directly overlap with corresponding changes in this retrieved PR.

Suggested labels

2: Editor Review

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'V11.9 Docs' is overly vague and generic, using non-descriptive terms that don't convey meaningful information about the specific changes in the changeset. Replace the generic title with a more specific summary of the main changes, such as 'Document v11.9 features: attribute masking, video calls support, and plugin configuration' to better reflect the actual changeset.
Description check ❓ Inconclusive No pull request description was provided by the author, making it impossible to evaluate whether it relates to the changeset. Add a description explaining the documentation updates for v11.9, including the new features and changes being documented 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.

✏️ 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.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

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.

4 participants