Dot release docs for v11.8.4, v11.7.7, and v10.11.22 by amyblais · Pull Request #9087 · mattermost/docs

amyblais · 2026-07-07T08:50:03Z

🤖 Generated with Claude Code

coderabbitai · 2026-07-07T08:50:12Z

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

Documentation updates add Mattermost v10.11.22, v11.8.4, and v11.7.7 release notes and update deployment links, release tables, and Enterprise/Team archive entries.

Changes

Release version bump documentation

Layer / File(s)	Summary
Changelog entries for new releases `source/product-overview/mattermost-v10-changelog.md`, `source/product-overview/mattermost-v11-changelog.md`	Added changelog entries covering release metadata, security fixes, plugin versions, API changes, bug fixes, and database-change statements.
Deployment download and release table updates `source/deployment-guide/server/linux/deploy-rhel.rst`, `source/deployment-guide/server/linux/deploy-tar.rst`, `source/product-overview/mattermost-server-releases.md`	Updated Current ESR tarball commands and release-table download and SBOM references for newer patch releases.
Version archive entries `source/product-overview/version-archive.rst`	Advanced Enterprise and Team entries to v11.8.4, v11.7.7, and v10.11.22, updating related URLs and replacing checksums with `TBD`.

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

Possibly related PRs

mattermost/docs#9047: Updates the same release documentation for adjacent Mattermost patch releases.
mattermost/docs#9064: Modifies the same deployment, release, changelog, and archive documentation surfaces.
mattermost/docs#9019: Updates the v10.11 changelog with related release-note content.

Suggested labels: Guidance

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description is generic and does not summarize the pull request changes.	Replace it with a brief summary of the documentation updates or the release versions affected.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title matches the main change: documentation updates for the v11.8.4, v11.7.7, and v10.11.22 dot releases.
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 dot-release-docs-10.11.22

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

Copilot

Pull request overview

Prepares Mattermost documentation for the upcoming v10.11.22 ESR dot release by updating release references across the changelog and archive pages.

Changes:

Add a v10.11.22 entry to the v10 changelog.
Bump the v10.11 row in the server releases table to point to 10.11.22 artifacts and SBOM links.
Update the version archive entries (Enterprise/Team) from 10.11.21 to 10.11.22.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
source/product-overview/version-archive.rst	Updates Enterprise/Team archive entries to v10.11.22 (currently with placeholder checksums).
source/product-overview/mattermost-v10-changelog.md	Adds the v10.11.22 changelog entry, including a planned release date and bullet list of changes.
source/product-overview/mattermost-server-releases.md	Updates the v10.11 row download + SBOM links to v10.11.22.

github-actions · 2026-07-07T08:53:34Z

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

github-actions · 2026-07-08T06:47:29Z

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

github-actions · 2026-07-08T06:47:32Z

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

github-actions · 2026-07-08T07:31:47Z

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

github-actions · 2026-07-08T07:35:36Z

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

github-actions · 2026-07-08T07:37:35Z

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

github-actions · 2026-07-08T07:37:36Z

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

coderabbitai

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)

source/product-overview/mattermost-v11-changelog.md (1)
370-380: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use a repository-relative upgrade-guide link.

Line 371 repeats the absolute internal documentation URL. Use the repository-relative Markdown link instead.

As per coding guidelines, in .md files, use relative Markdown links for whole documentation pages.
🤖 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/product-overview/mattermost-v11-changelog.md` around lines 370 - 380,
Update the upgrading link in the v11.7.7 changelog entry to use the
repository-relative Markdown path for the upgrade guide instead of the absolute
docs.mattermost.com URL. Keep the link text and surrounding release notes
unchanged.
Source: Coding guidelines
source/product-overview/version-archive.rst (2)
19-28: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use native Sphinx links for the new changelog references.

The new rows hard-code internal docs.mattermost.com changelog URLs. Replace these with :doc: links for whole pages or :ref: links to the corresponding release labels.

As per coding guidelines, in .rst files, use :doc: for page links and prefer :ref: for durable cross-page section links.

Also applies to: 69-73, 502-511, 552-556
🤖 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/product-overview/version-archive.rst` around lines 19 - 28, Replace
the hard-coded docs.mattermost.com changelog URLs in the version archive
entries, including the v11.8.4 and v11.7.7 rows and the additionally affected
rows, with native Sphinx links. Use :doc: for whole-page references or the
corresponding :ref: release labels for durable release-section links, while
preserving the displayed link text and other release metadata.
Source: Coding guidelines

19-28: 🔒 Security & Privacy | 🟠 Major | ⚡ Quick win

Populate the release checksums before publishing the archive.

The new Enterprise and Team Edition entries publish TBD instead of SHA-256 digests. Because this page directs administrators to verify the official, unmodified release using those checksums, the verification workflow is currently unusable for v11.8.4, v11.7.7, and v10.11.22. Replace every placeholder with the actual release checksum before merging.

Also applies to: 69-73, 502-511, 552-556
🤖 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/product-overview/version-archive.rst` around lines 19 - 28, Replace
every SHA-256 Checksum placeholder marked TBD in the new Enterprise and Team
Edition release entries, including v11.8.4, v11.7.7, and v10.11.22, with the
actual corresponding release digests. Ensure each checksum matches its published
archive before merging.

🧹 Nitpick comments (1)

source/product-overview/mattermost-v11-changelog.md (1)
183-186: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use repository-native links for internal documentation.

The new entries hard-code internal Mattermost documentation URLs. Use relative Markdown links in the changelog and native Sphinx cross-references in the archive.

source/product-overview/mattermost-v11-changelog.md Lines 183-186: convert the v11.8.4 upgrade link to a relative Markdown link.

source/product-overview/mattermost-v11-changelog.md Lines 370-380: convert the v11.7.7 upgrade link to a relative Markdown link.

source/product-overview/version-archive.rst Lines 19-28: use :doc: or :ref: for the v11.8.4 changelog link.

source/product-overview/version-archive.rst Lines 69-73: use :doc: or :ref: for the v10.11.22 changelog link.

source/product-overview/version-archive.rst Lines 502-511: use :doc: or :ref: for the v11.8.4/v11.7.7 changelog links.

source/product-overview/version-archive.rst Lines 552-556: use :doc: or :ref: for the v10.11.22 changelog link.

As per coding guidelines, internal documentation links must use repo-appropriate Markdown or Sphinx link syntax.
🤖 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/product-overview/mattermost-v11-changelog.md` around lines 183 - 186,
Replace the hard-coded internal documentation URLs with repository-native links:
in source/product-overview/mattermost-v11-changelog.md lines 183-186 and
370-380, use relative Markdown links for the upgrade references; in
source/product-overview/version-archive.rst lines 19-28, 69-73, 502-511, and
552-556, use appropriate :doc: or :ref: cross-references for the referenced
changelogs.
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.

Inline comments:
In `@source/product-overview/mattermost-v11-changelog.md`:
- Around line 183-186: Update the [Upgrading] link in the 11.8.4 changelog entry
to use the repository-relative Markdown path
../administration-guide/upgrade/upgrading-mattermost-server.md instead of the
absolute documentation URL; leave the surrounding release notes unchanged.

---

Outside diff comments:
In `@source/product-overview/mattermost-v11-changelog.md`:
- Around line 370-380: Update the upgrading link in the v11.7.7 changelog entry
to use the repository-relative Markdown path for the upgrade guide instead of
the absolute docs.mattermost.com URL. Keep the link text and surrounding release
notes unchanged.

In `@source/product-overview/version-archive.rst`:
- Around line 19-28: Replace the hard-coded docs.mattermost.com changelog URLs
in the version archive entries, including the v11.8.4 and v11.7.7 rows and the
additionally affected rows, with native Sphinx links. Use :doc: for whole-page
references or the corresponding :ref: release labels for durable release-section
links, while preserving the displayed link text and other release metadata.
- Around line 19-28: Replace every SHA-256 Checksum placeholder marked TBD in
the new Enterprise and Team Edition release entries, including v11.8.4, v11.7.7,
and v10.11.22, with the actual corresponding release digests. Ensure each
checksum matches its published archive before merging.

---

Nitpick comments:
In `@source/product-overview/mattermost-v11-changelog.md`:
- Around line 183-186: Replace the hard-coded internal documentation URLs with
repository-native links: in source/product-overview/mattermost-v11-changelog.md
lines 183-186 and 370-380, use relative Markdown links for the upgrade
references; in source/product-overview/version-archive.rst lines 19-28, 69-73,
502-511, and 552-556, use appropriate :doc: or :ref: cross-references for the
referenced changelogs.

🪄 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: f8f05aa6-ce2d-4e04-8c08-2e8ceb58cf29

📥 Commits

Reviewing files that changed from the base of the PR and between e0cf4f1 and b5a05ae.

📒 Files selected for processing (5)

source/deployment-guide/server/linux/deploy-rhel.rst
source/deployment-guide/server/linux/deploy-tar.rst
source/product-overview/mattermost-server-releases.md
source/product-overview/mattermost-v11-changelog.md
source/product-overview/version-archive.rst

🚧 Files skipped from review as they are similar to previous changes (1)

source/product-overview/mattermost-server-releases.md

github-actions · 2026-07-16T06:40:14Z

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

github-actions · 2026-07-16T09:47:31Z

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

github-actions · 2026-07-16T10:46:23Z

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

github-actions · 2026-07-16T10:47:08Z

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

github-actions · 2026-07-16T10:48:13Z

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

* Update mattermost-v11-changelog.md (#9098) * Update generate_changelog.py * Update generate_changelog.py * Enhance SAML configuration instructions for Mattermost (#8914) * Enhance SAML configuration instructions for Mattermost Updated instructions for configuring SAML attributes and claims in Entra for Mattermost integration, including detailed explanations of required and additional claims. * Update sso-saml-entraid.rst * Update sso-saml-entraid.rst * Update sso-saml-entraid.rst * Add image for Tenant ID location in Entra Added an image reference for the Tenant ID location in Entra. * Add files via upload * Fix formatting of image attributes in SSO SAML guide * Update source/administration-guide/onboard/sso-saml-entraid.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update source/administration-guide/onboard/sso-saml-entraid.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update source/administration-guide/onboard/sso-saml-entraid.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update source/administration-guide/onboard/sso-saml-entraid.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update source/administration-guide/onboard/sso-saml-entraid.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add files via upload * Update source/administration-guide/onboard/sso-saml-entraid.rst Make assigning users/groups the default path in step 8; move the "Assignment required? = No" option into a warning directive that notes it grants access to all tenant users and prompts the reader to evaluate fit for their environment. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Update source/administration-guide/onboard/sso-saml-entraid.rst Clarify Sign Request step to distinguish Mattermost signing outbound AuthnRequests from Entra signing responses/assertions; specify that Entra requires RSA-SHA256 for signed requests; add missing Entra-side step to upload the SP public certificate under Verification certificates. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: Combs7th <147677911+Combs7th@users.noreply.github.com> --------- Co-authored-by: Katie Wiersgalla <39744472+wiersgallak@users.noreply.github.com> Co-authored-by: Sven Hüster <sven@mattermost.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: Combs7th <147677911+Combs7th@users.noreply.github.com>

github-actions · 2026-07-17T07:38:03Z

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

github-actions · 2026-07-17T07:38:16Z

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

github-actions · 2026-07-17T07:38:45Z

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

github-actions · 2026-07-17T07:46:09Z

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

github-actions · 2026-07-17T07:49:37Z

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

github-actions · 2026-07-17T07:50:03Z

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

github-actions · 2026-07-17T07:51:02Z

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

amyblais added 3 commits July 7, 2026 11:49

Bump v10.11 download link to v10.11.22

6821163

Add v10.11.22 dot release changelog entry

3e1743a

Add v10.11.22 to version archive

cb72551

Copilot AI review requested due to automatic review settings July 7, 2026 08:50

Copilot started reviewing on behalf of amyblais July 7, 2026 08:50 View session

Copilot AI reviewed Jul 7, 2026

View reviewed changes

Comment thread source/product-overview/version-archive.rst

Comment thread source/product-overview/version-archive.rst

Comment thread source/product-overview/mattermost-server-releases.md

Comment thread source/product-overview/mattermost-v10-changelog.md

amyblais added the Work In Progress Not yet ready for review label Jul 7, 2026

amyblais added 5 commits July 8, 2026 09:43

Bump v11.7 download link to v11.7.7

eb2f7a3

Add v11.7.7 dot release changelog entry

7c1e44a

Add v11.7.7 to version archive

537f870

Bump current ESR to v11.7.7

d45a636

Bump current ESR to v11.7.7

23ebcb7

amyblais changed the title ~~Dot release docs for v10.11.22~~ Dot release docs for v11.7.7 and v10.11.22 Jul 8, 2026

Add v11.8.4 placeholder changelog entry

5222527

amyblais changed the title ~~Dot release docs for v11.7.7 and v10.11.22~~ Dot release docs for v11.7.7, v10.11.22, and v11.8.4 (placeholder) Jul 8, 2026

amyblais changed the title ~~Dot release docs for v11.7.7, v10.11.22, and v11.8.4 (placeholder)~~ Dot release docs for v11.8.4, v11.7.7, and v10.11.22 Jul 8, 2026

coderabbitai Bot approved these changes Jul 8, 2026

View reviewed changes

amyblais added 5 commits July 8, 2026 10:31

Merge branch 'master' into dot-release-docs-10.11.22

96d13f4

Update deploy-rhel.rst

733cdec

Update deploy-tar.rst

ee5e615

Update mattermost-server-releases.md

b24b6d6

Update version-archive.rst

8767ab5

Merge branch 'master' into dot-release-docs-10.11.22

b5a05ae

coderabbitai Bot requested changes Jul 16, 2026

View reviewed changes

Comment thread source/product-overview/mattermost-v11-changelog.md Outdated

Merge branch 'master' into dot-release-docs-10.11.22

d1f1de3

coderabbitai Bot approved these changes Jul 16, 2026

View reviewed changes

amyblais added 3 commits July 16, 2026 13:42

Update mattermost-v10-changelog.md

fe45354

Update mattermost-v11-changelog.md

1261546

Update mattermost-v11-changelog.md

4562bf1

amyblais and others added 3 commits July 17, 2026 10:34

Update mattermost-mobile-releases.md

1ec89b2

Update mobile-app-changelog.md

4dadc65

Merge branch 'master' into dot-release-docs-10.11.22

185ce4e

amyblais removed 3: Reviews Complete All reviewers have approved the pull request Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) labels Jul 17, 2026

Update mattermost-v10-changelog.md

9f03fc5

amyblais added 2 commits July 17, 2026 10:46

Update mattermost-v11-changelog.md

3af800b

Update version-archive.rst

8663ec1

amyblais merged commit 6b23cdf into master Jul 17, 2026
5 checks passed

amyblais deleted the dot-release-docs-10.11.22 branch July 17, 2026 07:51

Uh oh!

Conversation

amyblais commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

❌ Failed checks (1 inconclusive)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 7, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 16, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

amyblais commented Jul 7, 2026 •

edited

Loading

coderabbitai Bot commented Jul 7, 2026 •

edited

Loading