Skip to content

docs(self-hosted): add versions to avoid upgrading to#17388

Merged
aldy505 merged 1 commit intomasterfrom
aldy505/self-hosted/version-avoid-migration-issue
Apr 20, 2026
Merged

docs(self-hosted): add versions to avoid upgrading to#17388
aldy505 merged 1 commit intomasterfrom
aldy505/self-hosted/version-avoid-migration-issue

Conversation

@aldy505
Copy link
Copy Markdown
Collaborator

@aldy505 aldy505 commented Apr 20, 2026

This needs to be documented somehow.

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Apr 20, 2026 8:13am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored Apr 20, 2026 8:13am

Request Review

Comment on lines +65 to 66
- 26.4.0 (issues around `InconsistentMigrationHistory` during database migration)
As an example if one wants to go from `22.8.0` to `24.2.0` one needs the following upgrade path:
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Missing blank line between last list item and "As an example" paragraph causes it to render as part of the list item.
Severity: LOW

Suggested Fix

Add a blank line between line 65 (- 26.4.0 (issues around ...)) and line 66 (As an example if one wants to go from...) to properly separate the list from the following paragraph.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: develop-docs/self-hosted/releases.mdx#L65-L66

Potential issue: The PR removed the blank line that previously separated the
bullet-point list ("Versions to avoid upgrading to") from the "As an example" paragraph.
In Markdown/MDX, without a blank line after the last list item (`- 26.4.0 ...`), the
subsequent "As an example if one wants to go from `22.8.0` to `24.2.0`..." text will be
rendered as a continuation of the last bullet point rather than as a standalone
paragraph. This makes important upgrade path instructions visually subordinate to an
unrelated list item, potentially confusing self-hosted users trying to follow the
upgrade guide.

Did we get this right? 👍 / 👎 to inform future reviews.

@aldy505 aldy505 enabled auto-merge (squash) April 20, 2026 08:13
@aldy505 aldy505 merged commit 1510d7a into master Apr 20, 2026
18 checks passed
@aldy505 aldy505 deleted the aldy505/self-hosted/version-avoid-migration-issue branch April 20, 2026 08:14
@github-actions github-actions Bot locked and limited conversation to collaborators May 6, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants