Skip to content

ESR docs updates#9112

Closed
amyblais wants to merge 14 commits into
v11.10-documentationfrom
claude/issue-9111-20260721-1005
Closed

ESR docs updates#9112
amyblais wants to merge 14 commits into
v11.10-documentationfrom
claude/issue-9111-20260721-1005

Conversation

@amyblais

Copy link
Copy Markdown
Member

Closes #9111

Generated with Claude Code

- 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>
Copilot AI review requested due to automatic review settings July 21, 2026 10:10
@amyblais amyblais added the Work In Progress Not yet ready for review label Jul 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

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

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

Comment thread source/product-overview/release-policy.md
Comment thread source/product-overview/release-policy.md
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

The release policy updates general ESR lifecycle wording, marks the v10.11 and Desktop App v5.13 ESR as completed, reorders timeline legend entries, and expands the legacy-release description to include v10.0.

Changes

ESR release policy

Layer / File(s) Summary
ESR lifecycle wording
source/product-overview/release-policy.md
The ESR section now describes the server and desktop support cadence and duration as a general policy.
Release status records
source/product-overview/release-policy.md
The timeline marks v10.11 and Desktop App v5.13 support as completed, reorders the legend entries, and includes v10.0 in the legacy-release description.

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

🚥 Pre-merge checks | ✅ 1 | ❌ 4

❌ Failed checks (2 warnings, 2 inconclusive)

Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning It updates the page, but the required v10.11/v5.13 legacy entry and related-page consistency updates from #9111 are missing. Add the v10.11/v5.13 legacy entry with the August 15, 2026 end date and keep the historical ESR cadence wording intact.
Out of Scope Changes check ⚠️ Warning The v10.0 addition in Legacy Releases is outside the v10.11/v5.13 ESR transition request. Remove the v10.0 expansion unless it is required by a separate issue.
Title check ❓ Inconclusive The title is related, but it's too vague to tell what ESR docs changed. Use a more specific title naming the main documentation change, such as the ESR lifecycle and support updates in release-policy.md.
Description check ❓ Inconclusive The description is related only through the issue link, but it doesn't describe the documentation changes. Add a short summary of the ESR documentation updates and the affected release-policy details.
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ 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 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 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: 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

Comment thread source/product-overview/common-esr-support-upgrade.md Outdated
Comment thread source/product-overview/release-policy.md Outdated
@github-actions

Copy link
Copy Markdown
Contributor

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

@amyblais
amyblais changed the base branch from master to v11.10-documentation July 21, 2026 10:19
@amyblais amyblais added this to the v11.10.0 milestone Jul 21, 2026

@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: 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

Comment thread source/product-overview/release-policy.md
Comment thread source/product-overview/release-policy.md
@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@github-actions

Copy link
Copy Markdown
Contributor

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

@coderabbitai coderabbitai Bot mentioned this pull request Jul 22, 2026
@amyblais amyblais closed this Jul 22, 2026
@mattermost-build mattermost-build removed the Work In Progress Not yet ready for review label Jul 22, 2026
@amyblais amyblais removed this from the v11.10.0 milestone Jul 22, 2026
@amyblais
amyblais deleted the claude/issue-9111-20260721-1005 branch July 22, 2026 12:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ESR docs updates

3 participants