Skip to content

Update the docs for the stable 2.0 release - #607

Merged
imorland merged 2 commits into
flarum:mainfrom
karl-bullock:docs-2-0-stable-switchover
Oct 9, 2026
Merged

imorland merged 2 commits into
flarum:mainfrom
karl-bullock:docs-2-0-stable-switchover

Conversation

@karl-bullock

Copy link
Copy Markdown
Member

Draft until v2.0.0 is tagged. Merging this before then breaks the install command, because composer create-project flarum/flarum:^2.0.0 with no --stability=beta finds nothing to install while only RCs exist.

Closes the mechanical part of #596:

  • install.md: removed the release-candidate :::warning.
  • install.md: dropped --stability=beta from the create-project command.
  • install.md: the archive table still lists 2.0.0-rc.8. Not touched here, because its links must point at the stable packages in flarum/installation-packages, which do not exist until the release is built. That is the usual table routine (Update 2.x install download links for v2.0.0-rc.6 #580, Update 2.x install download links for v2.0.0-rc.7 #582, Update 2.x install download links for v2.0.0-rc.8 #583), run once more against the stable tag.
  • update.md: replaced the release-candidate :::warning with a plain one. The old text carried the only "back up and test on a staging copy" advice in the guide, so I kept that part and dropped the RC framing.
  • update.md: removed step 5, "Set minimum-stability to beta", along with its :::info saying to switch back to stable after release. Steps 6 to 8 are now 5 to 7; nothing on the page or elsewhere in the docs refers to them by number. Forums coming from 1.x already have minimum-stability: beta with prefer-stable: true from the 1.x skeleton, and that resolves stable releases without any change.
  • extend/update-2_0.md: flarum/core requirement ^2.0.0-beta becomes ^2.0.

Merge note: this conflicts with #606 on one line of update.md, the "Disable third-party extensions" step. #606 adds a sentence to it and this PR renumbers it from 8 to 7. Whichever lands second should keep **7. with #606's added sentence. It merges cleanly with #592 and #595, the other open PRs touching these files.

Removes the release-candidate warnings from the install and upgrade
guides, drops --stability=beta from the install command and the
minimum-stability: beta upgrade step, and sets the extension upgrade
guide's flarum/core requirement to ^2.0. Refs flarum#596.
@imorland

imorland commented Oct 9, 2026

Copy link
Copy Markdown
Member

@copilot resolve the merge conflicts in this pull request

# Conflicts:
#	docs/update.md
@imorland
imorland marked this pull request as ready for review October 9, 2026 22:04
@imorland
imorland merged commit 9097fb3 into flarum:main Oct 9, 2026
5 checks passed
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.

2 participants