Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
aldy505 merged 1 commit into from
Apr 20, 2026
Merged

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion develop-docs/self-hosted/releases.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,12 @@ These are the hard stops that one needs to go through:

Versions to avoid upgrading to:
- 23.7.0 (issues around database migrations and the Django 3 upgrade)

- 25.6.0 (migration error)
- 25.6.1 (failed fix for the migration error in 25.6.0)
- 25.9.0 (issues around attachment storage setup)
- 25.12.0 (issues around `InconsistentMigrationHistory` during database migration)
- 26.3.0 (issues around `InconsistentMigrationHistory` during database migration)
- 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:
Comment on lines +65 to 66
Copy link
Copy Markdown
Contributor

@sentry sentry Bot Apr 20, 2026

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.


```
Expand Down
Loading