Skip to content

Document the Ranked attribute type#9086

Merged
amyblais merged 1 commit into
v11.9-documentationfrom
dk-ranked-attribute-docs
Jul 10, 2026
Merged

Document the Ranked attribute type#9086
amyblais merged 1 commit into
v11.9-documentationfrom
dk-ranked-attribute-docs

Conversation

@davidkrauser

Copy link
Copy Markdown
Contributor

Add a Ranked entry to the user-attribute type list, document its ordered comparison operators in the system-wide access policy match options, and note that classification markings use the same Ranked attribute type.

Add a Ranked entry to the user-attribute type list, document its ordered
comparison operators in the system-wide access policy match options, and
note that classification markings use the same Ranked attribute type.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@davidkrauser
davidkrauser requested a review from Combs7th July 6, 2026 19:15
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

This PR updates Mattermost documentation to describe a new Ranked user attribute type. Changes clarify that classification markings use Ranked attributes for ordering, and document supported ordered comparison operators for Ranked attributes in ABAC Simple Mode policy configuration.

Changes

Ranked Attribute Documentation

Layer / File(s) Summary
Ranked attribute type definition
source/administration-guide/manage/admin/user-attributes.rst
Adds the Ranked attribute type to the supported types list, describing ordered-value behaviour and threshold-based comparisons.
ABAC Simple Mode comparison options
source/administration-guide/manage/admin/abac-system-wide-policies.rst
Documents ordered comparison match options for Ranked attributes (exact/not, at least/greater than, at most/less than) in Simple Mode policy configuration.
Classification markings ordering
source/administration-guide/configure/site-configuration-settings.rst
Clarifies that classification level ordering uses the Ranked attribute type, aligning with user attribute behaviour.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Related Issues: None specified

Related PRs: None specified

Suggested labels: documentation

Suggested reviewers: None specified

Poem
A rabbit hops through docs anew,
Ranking levels, low to high, in view.
Thresholds set where matches lie,
Classification ranks reach for the sky.
Three files touched, one concept true. 🐇

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 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 clearly summarizes the main documentation change: introducing the Ranked attribute type.
Description check ✅ Passed The description matches the documented changes to user attributes, policy match options, and classification markings.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch dk-ranked-attribute-docs

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

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

@Combs7th Combs7th added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels Jul 8, 2026
@Combs7th Combs7th added this to the v11.9.0 milestone Jul 8, 2026
@amyblais
amyblais changed the base branch from master to v11.9-documentation July 8, 2026 06:09
@davidkrauser

Copy link
Copy Markdown
Contributor Author

@amyblais quick question about the workflow for documentation changes: if this goes directly into the v11.9 branch, how will it get into master for future releases? Do I need to open another PR for that?

@davidkrauser
davidkrauser requested a review from pvev July 8, 2026 15:42
@amyblais amyblais removed the 2: Editor Review Requires review by an editor label Jul 8, 2026
@amyblais

amyblais commented Jul 8, 2026

Copy link
Copy Markdown
Member

quick question about the workflow for documentation changes: if this goes directly into the v11.9 branch, how will it get into master for future releases? Do I need to open another PR for that?

@davidkrauser I will merge the v11.9 branch into the master branch via this PR #9043 on the release day.

@esethna

esethna commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

@pvev friendly ping on review here, thanks!

@amyblais amyblais added 3: Reviews Complete All reviewers have approved the pull request and removed 1: Dev Review Requires review by a core commiter labels Jul 10, 2026
@amyblais
amyblais merged commit dfb44a7 into v11.9-documentation Jul 10, 2026
9 checks passed
@amyblais
amyblais deleted the dk-ranked-attribute-docs branch July 10, 2026 05:46
amyblais added a commit that referenced this pull request Jul 16, 2026
* Update conf.py

* MM-68992 - add attribute value masking documentation (#9000)

* MM-68992 - add attribute value masking documentation

* add details about access mode

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

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

* Note external RTCD v1.2.2+ requirement for DM video calls

* MM-69311: Document new metric: mattermost_cluster_reliable_fallback_tcp (#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>

* Document DCR redirect URI allowlist wildcard and query matching behavior (#9065)

Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>

* Document the Ranked attribute type (#9086)

Add a Ranked entry to the user-attribute type list, document its ordered
comparison operators in the system-wide access policy match options, and
note that classification markings use the same Ranked attribute type.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* v11.9.0 Changelog (#9053)

* docs: add changelog for v11.9.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 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: Christopher Poile <cpoile@gmail.com>

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Update mattermost-v11-changelog.md

* Add 3 bug fix release notes to v11.9.0 changelog

* Update source/product-overview/mattermost-v11-changelog.md

Co-authored-by: Christopher Poile <cpoile@gmail.com>

* Update mattermost-v11-changelog.md

* Add Jira plugin v4.7.1 release note to v11.9.0 changelog

* Fix: use Pre-packaged for Jira plugin v4.7.1 release note

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

* Add attribute value masking information to 11.8.0 changelog docs

* move changes under v11.9 section

* Add inline link for attribute value masking in v11.9 changelog

* Update Agents plugin version from v2.4.1 to v2.4.2 in v11.9 changelog

* Add Global Relay crash fix to v11.9 Bug Fixes section

* Add Global Relay fix to v11.9 Bug Fixes with correct wording

* Add inline link for metric on line 106

* Update v11.9 changelog: bug fix, feature flag note, Calls v1.12.1

* Fix formatting: backticks for feature flags, bold for Channel Settings Permissions Policy

* Update source/product-overview/mattermost-v11-changelog.md

Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update v11.9 changelog: replace feature flag line 110 with ChannelPermissionPolicies/PolicySimulation description

* Add PropertyGroups and channelbookmarks schema changes to v11.9 changelog

* Update mattermost-v11-changelog.md

* Add ChannelGuards schema change to v11.9 changelog

* Add stale config refresh fix to v11.9 changelog

* Update mattermost-v11-changelog.md

* Add Bot Accounts pagination fix to v11.9 changelog

* Remove duplicate Boards plugin version line

* 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: Christopher Poile <cpoile@gmail.com>
Co-authored-by: Pablo Vélez <pablovv2012@gmail.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>

* Update version-archive.rst (#9092)

* v11.9 release docs (#9058)

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

---------

Co-authored-by: Pablo Vélez <pablovv2012@gmail.com>
Co-authored-by: Bill Gardner <billg@wavearts.com>
Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
Co-authored-by: Eric Sethna <14333569+esethna@users.noreply.github.com>
Co-authored-by: David Krauser <david@krauser.org>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: changelog-automation-docs[bot] <278388344+changelog-automation-docs[bot]@users.noreply.github.com>
Co-authored-by: Changelog Bot <changelog-bot@mattermost.com>
Co-authored-by: Christopher Poile <cpoile@gmail.com>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3: Reviews Complete All reviewers have approved the pull request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants