V11.7 Docs#8895
Conversation
|
Note Reviews pausedIt 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 Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
📝 WalkthroughWalkthroughDocumentation and Sphinx metadata updates: bumped commented Sphinx version to '11.7'; replaced v10.5 ESR references with v10.11 and recommended upgrade target v11.7 across product-overview and upgrade docs; adjusted release-policy timeline date; added enterprise-search health-check behaviour, reconnection/backoff, sample logs, and a new Prometheus metric; added ChangesSphinx configuration
ESR upgrade guidance & release policy
Enterprise search behaviour and metrics
Environment configuration settings
Sequence Diagram(s)sequenceDiagram
autonumber
participant Mattermost as Mattermost Server
participant SearchEngine as Elasticsearch/OpenSearch
participant DB as Database
participant Prom as Prometheus
rect rgba(200,200,255,0.5)
Mattermost->>SearchEngine: periodic health check
end
alt health OK
SearchEngine-->>Mattermost: healthy
Note right of Mattermost: continue using search engine
else first failure
SearchEngine-->>Mattermost: unhealthy
Mattermost->>DB: route search queries to database (fallback)
Mattermost->>Prom: expose metric mattermost_search_engine_status = 0
Note right of Mattermost: start exponential-backoff retries
end
opt consecutive failures
Mattermost->>SearchEngine: disable engine, stop forwarding
Mattermost->>Prom: metric remains 0
end
opt recovery
SearchEngine-->>Mattermost: responds healthy
Mattermost->>SearchEngine: resume engine, re-evaluate config/license
Mattermost->>Prom: metric mattermost_search_engine_status = 1
end
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~20 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 3 | ❌ 2❌ Failed checks (2 inconclusive)
✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Tip 💬 Introducing Slack Agent: The best way for teams to turn conversations into code.Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.
Built for teams:
One agent for your entire SDLC. Right inside Slack. 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. Comment |
There was a problem hiding this comment.
Pull request overview
Updates the Sphinx documentation configuration to reflect the Mattermost 11.7 documentation version, aligning the docs build metadata with the “V11.7 Docs” release.
Changes:
- Bumps the commented Sphinx
versionplaceholder from11.6to11.7. - Bumps the commented Sphinx
releaseplaceholder from11.6to11.7.
|
Newest code from mattermost has been published to preview environment for Git SHA cb3019b |
|
Newest code from mattermost has been published to preview environment for Git SHA ec06c14 |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
|
Newest code from mattermost has been published to preview environment for Git SHA 9e260d9 |
|
Newest code from mattermost has been published to preview environment for Git SHA 9603a85 |
* Update ESR docs to reflect v10.11 end-of-life on August 15, 2026 Update placeholder ESR notices across docs to indicate that Mattermost Server v10.11 ESR is coming to end of life on August 15, 2026, and that upgrading to v11.7 or later is recommended. Also update upgrade path examples to include v11.7 ESR. Co-authored-by: Amy Blais <amyblais@users.noreply.github.com> * Update common-esr-support-upgrade.md * Update release-policy.md --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Amy Blais <amyblais@users.noreply.github.com>
|
Newest code from mattermost has been published to preview environment for Git SHA b19d633 |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@source/product-overview/release-policy.md`:
- Line 86: Replace the hardcoded absolute URLs in the sentence referencing the
v10.11 ESR and v11.7 ESR with repo-appropriate relative Markdown links: locate
the two inline links whose link text is "v10.11 ESR" and "v11.7 ESR" and convert
each href from the full https://docs.mattermost.com/... URL to the corresponding
relative path used by the repo (relative Markdown link syntax) so the links
point to the same internal doc pages without the external domain.
🪄 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: 2bf7bc80-543f-4b69-8e1a-1ab4a9308fe9
📒 Files selected for processing (5)
source/administration-guide/upgrade/prepare-to-upgrade-mattermost.rstsource/product-overview/common-esr-support-rst.rstsource/product-overview/common-esr-support-upgrade.mdsource/product-overview/common-esr-support.mdsource/product-overview/release-policy.md
✅ Files skipped from review due to trivial changes (4)
- source/product-overview/common-esr-support-rst.rst
- source/administration-guide/upgrade/prepare-to-upgrade-mattermost.rst
- source/product-overview/common-esr-support.md
- source/product-overview/common-esr-support-upgrade.md
|
Newest code from mattermost has been published to preview environment for Git SHA 5c9347c |
|
Newest code from mattermost has been published to preview environment for Git SHA 3459a12 |
* Add new ES/OS behaviour on outages * Document new fast-fail behaviour and health metric
|
Newest code from mattermost has been published to preview environment for Git SHA 032c883 |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In
`@source/administration-guide/scale/common-configure-mattermost-for-enterprise-search.rst`:
- Line 43: The sentence currently reads as unconditional that "the Mattermost
Server will fall back on Database search"; update it to clarify the conditional
behavior: state that the server will fall back to Database Search only if
Database Search is enabled, and if Database Search has been disabled the server
cannot fall back and search will be unavailable during Elasticsearch/OpenSearch
outages. Update the sentence around the phrase "will fall back on Database
search" and keep the link to the outage handling FAQ (the :ref:`outage handling
FAQ <administration-guide/scale/enterprise-search:how does mattermost handle
elasticsearch or opensearch outages?>`) so readers know where to get details.
🪄 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: 727aeae4-b802-4ee3-8539-e45fb8cf416d
📒 Files selected for processing (3)
source/administration-guide/scale/common-configure-mattermost-for-enterprise-search.rstsource/administration-guide/scale/enterprise-search.rstsource/administration-guide/scale/performance-monitoring-metrics.rst
✅ Files skipped from review due to trivial changes (2)
- source/administration-guide/scale/performance-monitoring-metrics.rst
- source/administration-guide/scale/enterprise-search.rst
|
Newest code from mattermost has been published to preview environment for Git SHA f019823 |
…terialized views (#8846)
|
@Combs7th Please help approve this (but not merge yet) before Friday, May 15th. |
|
Newest code from mattermost has been published to preview environment for Git SHA 0ee5049 |
…8962) Adds a short admin-facing section noting that, from Mattermost Desktop v6.2.0, the same organization-level settings available via Windows group policy can be managed on macOS via managed preferences delivered through an MDM solution. Refs mattermost/desktop#3692 Resolves #8960 Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
|
Newest code from mattermost has been published to preview environment for Git SHA bd364c3 |
amyblais
removed
Do Not Merge
In Mattermost v11.7 (Agents v2.0), Rewrite is accessed through the new AI Actions menu instead of as a top-level message action. Custom prompts published by system admins appear in the same menu. This is the only Agents v2.0 product-docs change that belongs in mattermost/docs. The Agents end-user and admin guides are pulled from the mattermost-plugin-agents submodule and regenerated by Sphinx into source/_generated/agents/docs/, so equivalent edits to the user guide (mobile entry point, agent threads list, chat screen, bot/agent selector, auto-navigation) and to the admin guide (manage_own_agent, manage_others_agent) belong upstream in mattermost-plugin-agents PR #709 (or a follow-up plugin docs PR), not in this repo. Refs: #8952 Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
Adds mobile-app instructions for joining and leaving a team via the new bottom-sheet team menu introduced in Mattermost Mobile v2.40.0 (mattermost/mattermost-mobile#9721), and marks Leave team as supported on Mobile in the client availability table. Refs #8968 Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
…8967) Aligns docs prose with the mattermost/mattermost#36046 (MM-68235) rename landing in v11.7.0. Updates user-facing English in three pages while preserving internal identifiers that the PR confirms were NOT renamed: the mmctl cpa command syntax, API paths, JSON field names, audit event names (createCPAField, deleteCPAField, patchCPAField, patchCPAValues), WebSocket event strings, and i18n message keys. Refs: #8966 Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com>
…hinx (#8945) * Update agents submodule to latest master (v2 launch docs) Advances mattermost-plugin-agents to 43738eed (docs: add Agents v2 launch documentation #709). Co-authored-by: Cursor <cursoragent@cursor.com> * Exclude agents schema migration review Markdown from Sphinx build These files live in the plugin submodule for engineering review only; keep them off docs.mattermost.com and out of search. Co-authored-by: Cursor <cursoragent@cursor.com> --------- Co-authored-by: Cursor <cursoragent@cursor.com>
|
Newest code from mattermost has been published to preview environment for Git SHA bedf261 |
|
Newest code from mattermost has been published to preview environment for Git SHA d4f1493 |
|
Newest code from mattermost has been published to preview environment for Git SHA f4590b7 |
|
Newest code from mattermost has been published to preview environment for Git SHA 286402c |
|
Newest code from mattermost has been published to preview environment for Git SHA 91f3365 |
saturninoabril
left a comment
saturninoabril
left a comment
There was a problem hiding this comment.
Thanks @amyblais!
|
Newest code from mattermost has been published to preview environment for Git SHA ae8cfa0 |
To be merged on Friday, May 15th.