ESR docs updates by amyblais · Pull Request #9112 · mattermost/docs

amyblais · 2026-07-21T10:10:17Z

- release-policy: change v10.11 Gantt row from :crit to :done, add it to the Legacy Releases table (Support ended 2026-08-15), and update the timeline legend so the now-EOL ESR is listed under grey (not red) bars - Update shared ESR reminder snippets (common-esr-support.md, common-esr-support-upgrade.md, common-esr-support-rst.rst) to name both Server v10.11 and Desktop App v5.13 reaching end of support on August 15, 2026, keeping the reminder consistent across the desktop, server, changelog, and version-archive pages Co-authored-by: Amy Blais <29708087+amyblais@users.noreply.github.com>

github-actions · 2026-07-21T10:14:00Z

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

Copilot

Pull request overview

Updates Mattermost ESR lifecycle documentation to reflect the v10.11 / Desktop v5.13 transition and aligns shared “ESR support ending” snippets with server + desktop messaging.

Changes:

Updates the release-policy Mermaid Gantt legend/status and adds v10.11/v5.13 to the Legacy Releases table.
Updates shared Markdown and reStructuredText snippets to mention both Server v10.11 and Desktop App v5.13, plus recommended next ESR targets.

Reviewed changes

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

File	Description
source/product-overview/release-policy.md	Adjusts ESR timeline styling/legend and legacy table entries for v10.11/v5.13.
source/product-overview/common-esr-support.md	Updates shared ESR support-ending snippet to include desktop ESR and links to upgrade targets.
source/product-overview/common-esr-support-upgrade.md	Updates shared upgrade-focused ESR snippet to include desktop ESR messaging.
source/product-overview/common-esr-support-rst.rst	Updates reStructuredText version of the ESR support-ending snippet to include desktop ESR.

github-actions · 2026-07-21T10:15:34Z

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

github-actions · 2026-07-21T10:16:09Z

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

coderabbitai · 2026-07-21T10:18:27Z

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

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 9587bc50-e86d-432f-8018-7a0e7793160b

📥 Commits

Reviewing files that changed from the base of the PR and between 9511559 and c5b94e4.

📒 Files selected for processing (1)

source/product-overview/release-policy.md

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

source/product-overview/release-policy.md

📝 Walkthrough

Walkthrough

The documentation generalizes the ESR lifecycle policy and records the end of support for Mattermost Server v10.11. Upgrade guidance now requires v11.7 ESR or later.

Changes

ESR documentation

Layer / File(s)	Summary
Release policy status `source/product-overview/release-policy.md`	The ESR cadence is stated as nine months with 12 months of support. The release timeline and legacy-release guidance are updated.
End-of-life notices `source/product-overview/common-esr-support*`, `source/administration-guide/upgrade/prepare-to-upgrade-mattermost.rst`	v10.11 is described as having reached end of life. Upgrades to v11.7 ESR or later are required.

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

Possibly related PRs

mattermost/docs#9097: Updates the ESR cadence, timeline, and support status in release-policy.md.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Linked Issues check	⚠️ Warning	The changes update Server v10.11 documentation but omit Desktop v5.13 and several required release, archive, legacy, unsupported-release, and changelog updates [`#9111`].	Update the required Server and Desktop pages, legacy and unsupported-release tables, archives, and release or changelog reminders; apply the transition after August 15, 2026.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the primary change: updates to ESR documentation.
Description check	✅ Passed	The description links the pull request to the directly related ESR documentation issue.
Out of Scope Changes check	✅ Passed	The modified documentation files are related to the ESR support transition and do not introduce unrelated changes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch claude/issue-9111-20260721-1005

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

Actionable comments posted: 2

🤖 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/common-esr-support-upgrade.md`:
- Line 3: Replace the hardcoded internal documentation URLs in
source/product-overview/common-esr-support-upgrade.md lines 3-3 and
source/product-overview/common-esr-support.md lines 3-3 with repository-relative
Markdown links to release-policy.md, mattermost-server-releases.md, and
mattermost-desktop-releases.md, preserving the existing link text and content.

In `@source/product-overview/release-policy.md`:
- Line 52: Update the v10.11 and Desktop App v5.13 entry in the release-policy
timeline so it remains marked as supported until 2026-08-15; do not use the
ended-support status before that date.

🪄 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: 59960701-a9ac-4743-ac95-47659f03b798

📥 Commits

Reviewing files that changed from the base of the PR and between bbb48ba and 27898f0.

📒 Files selected for processing (4)

source/product-overview/common-esr-support-rst.rst
source/product-overview/common-esr-support-upgrade.md
source/product-overview/common-esr-support.md
source/product-overview/release-policy.md

github-actions · 2026-07-21T10:18:46Z

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

coderabbitai

Actionable comments posted: 2

Caution

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

⚠️ Outside diff range comments (1)

source/product-overview/release-policy.md (1)
50-50: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Document the v10.11/Desktop App v5.13 ESR consistently.

The required ESR pair is missing from both the release timeline and legacy-release records.

source/product-overview/release-policy.md#L50-L50: add the timeline bar with the correct lifecycle status and dates.

source/product-overview/release-policy.md#L84-L84: add the ESR pair to the legacy-release scope and table with an August 15, 2026 support-end date.
🤖 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/release-policy.md` at line 50, Document the
v10.11/Desktop App v5.13 ESR pair in source/product-overview/release-policy.md:
at lines 50-50, add its release-timeline bar with the correct lifecycle status
and dates; at lines 84-84, add the pair to the legacy-release scope and table
with a support-end date of August 15, 2026.

🧹 Nitpick comments (1)

source/product-overview/release-policy.md (1)
84-84: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use the repository’s internal link syntax.

Replace the hardcoded https://docs.mattermost.com/product-overview/unsupported-legacy-releases.html URL with the repository’s relative/internal documentation path.
🤖 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/release-policy.md` at line 84, Update the release
overview sentence in release-policy.md to replace the hardcoded unsupported
legacy releases URL with the repository’s relative/internal documentation link,
preserving the existing link text and sentence meaning.
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/release-policy.md`:
- Around line 28-30: Update the ESR lifecycle statement in the release policy to
qualify the 9-month release cadence and 12-month support duration as applying
starting with the August 2025 releases. Preserve the existing cadence and
support details while making clear that earlier ESR cohorts are excluded.
- Line 69: Update the v10.11 and Desktop App v5.13 entry in the release policy
so it does not state that support ended before August 15, 2026; keep it marked
as supported until that date, or publish the ended-support wording only on or
after August 15, 2026.

---

Outside diff comments:
In `@source/product-overview/release-policy.md`:
- Line 50: Document the v10.11/Desktop App v5.13 ESR pair in
source/product-overview/release-policy.md: at lines 50-50, add its
release-timeline bar with the correct lifecycle status and dates; at lines
84-84, add the pair to the legacy-release scope and table with a support-end
date of August 15, 2026.

---

Nitpick comments:
In `@source/product-overview/release-policy.md`:
- Line 84: Update the release overview sentence in release-policy.md to replace
the hardcoded unsupported legacy releases URL with the repository’s
relative/internal documentation link, preserving the existing link text and
sentence meaning.

🪄 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: 40fd4ebc-9d17-4f5d-abe3-a1466af1613f

📥 Commits

Reviewing files that changed from the base of the PR and between 27898f0 and b441b5f.

📒 Files selected for processing (1)

source/product-overview/release-policy.md

github-actions · 2026-07-22T08:12:40Z

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

github-actions · 2026-07-22T08:12:48Z

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

github-actions · 2026-07-22T08:13:05Z

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

github-actions · 2026-07-22T08:13:27Z

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

github-actions · 2026-07-29T14:10:48Z

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

github-actions · 2026-07-31T05:44:42Z

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

github-actions · 2026-08-03T05:58:45Z

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

github-actions · 2026-08-04T05:47:44Z

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

….rst This change was out of scope for the ESR docs update and flagged as such in review; removing it to keep the PR focused. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

github-actions · 2026-08-04T11:54:16Z

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

github-actions · 2026-08-06T05:50:46Z

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

github-actions · 2026-08-07T05:42:33Z

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

github-actions · 2026-08-11T05:29:52Z

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

github-actions · 2026-08-11T05:58:02Z

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

github-actions · 2026-08-11T06:07:26Z

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

Copilot AI review requested due to automatic review settings July 21, 2026 10:10

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

Copilot started reviewing on behalf of amyblais July 21, 2026 10:10 View session

amyblais added 3 commits July 21, 2026 13:12

Revert common-esr-support-rst.rst to master

62f1ca7

Revert common-esr-support-upgrade.md to master

abce0f1

Revert common-esr-support.md to master

2cf3650

Copilot AI reviewed Jul 21, 2026

View reviewed changes

Comment thread source/product-overview/release-policy.md Outdated

Comment thread source/product-overview/release-policy.md Outdated

Update release-policy.md

b441b5f

coderabbitai Bot requested changes Jul 21, 2026

View reviewed changes

Comment thread source/product-overview/common-esr-support-upgrade.md Outdated

Comment thread source/product-overview/release-policy.md Outdated

amyblais changed the base branch from master to v11.10-documentation July 21, 2026 10:19

amyblais added this to the v11.10.0 milestone Jul 21, 2026

coderabbitai Bot requested changes Jul 21, 2026

View reviewed changes

Comment thread source/product-overview/release-policy.md Outdated

Comment thread source/product-overview/release-policy.md

coderabbitai Bot approved these changes Jul 21, 2026

View reviewed changes

amyblais added 5 commits July 22, 2026 11:08

Update ESR support snippet to reflect v10.11 ESR has reached end of life

02179c1

Update ESR support snippet to reflect v10.11 ESR has reached end of life

4415b80

Update ESR support snippet to reflect v10.11 ESR has reached end of life

772d8c5

Update ESR support note to reflect v10.11 ESR has reached end of life

d23dd59

Update prepare-to-upgrade-mattermost.rst

7175819

amyblais added 2 commits July 22, 2026 11:13

Update common-esr-support-rst.rst

1a667c0

Update common-esr-support-upgrade.md

77ad1a1

coderabbitai Bot approved these changes Jul 29, 2026

View reviewed changes

Merge branch 'master' into claude/issue-9111-20260721-1005

cb52fb5

Merge branch 'master' into claude/issue-9111-20260721-1005

78f1f44

Merge branch 'master' into claude/issue-9111-20260721-1005

a527c1b

amyblais added 2: Editor Review Requires review by an editor Do Not Merge/Awaiting Next Release To be merged with the next release (e.g. API documentation updates) and removed Work In Progress Not yet ready for review labels Aug 4, 2026

amyblais requested review from Combs7th and lieut-data August 4, 2026 06:00

lieut-data approved these changes Aug 4, 2026

View reviewed changes

Comment thread source/administration-guide/upgrade/prepare-to-upgrade-mattermost.rst Outdated

Revert unrelated backtick/escape fix in prepare-to-upgrade-mattermost…

9511559

….rst This change was out of scope for the ESR docs update and flagged as such in review; removing it to keep the PR focused. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Merge branch 'master' into claude/issue-9111-20260721-1005

3857bbf

Combs7th approved these changes Aug 7, 2026

View reviewed changes

amyblais added 3: Reviews Complete All reviewers have approved the pull request and removed 2: Editor Review Requires review by an editor labels Aug 7, 2026

Merge branch 'master' into claude/issue-9111-20260721-1005

a44515a

Merge branch 'master' into claude/issue-9111-20260721-1005

1d6be14

Merge branch 'master' into claude/issue-9111-20260721-1005

888d854

Update release-policy.md

c5b94e4

coderabbitai Bot mentioned this pull request Aug 11, 2026

V11.10 Docs #9097

Open

Uh oh!

Conversation

amyblais commented Jul 21, 2026

Uh oh!

github-actions Bot commented Jul 21, 2026

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!

github-actions Bot commented Jul 21, 2026

Uh oh!

github-actions Bot commented Jul 21, 2026

Uh oh!

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

Uh oh!

Reviews paused

Walkthrough

Changes

❌ Failed checks (1 warning)

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 21, 2026

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 29, 2026

Uh oh!

github-actions Bot commented Jul 31, 2026

Uh oh!

github-actions Bot commented Aug 3, 2026

Uh oh!

github-actions Bot commented Aug 4, 2026

Uh oh!

Uh oh!

github-actions Bot commented Aug 4, 2026

Uh oh!

github-actions Bot commented Aug 6, 2026

Uh oh!

github-actions Bot commented Aug 7, 2026

Uh oh!

github-actions Bot commented Aug 11, 2026

Uh oh!

github-actions Bot commented Aug 11, 2026

Uh oh!

github-actions Bot commented Aug 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

coderabbitai Bot commented Jul 21, 2026 •

edited

Loading