From 0026475f5c9a104410ae824cb5a4d63fa3bdb1df Mon Sep 17 00:00:00 2001
From: Colin O'Dell <codell@seatgeek.com>
Date: Mon, 22 Jul 2024 14:07:01 -0400
Subject: [PATCH] Prepare to release 2.5.0

---
 CHANGELOG.md           | 5 ++++-
 composer.json          | 2 +-
 docs/2.5/upgrading.md  | 2 ++
 docs/_data/menu.yml    | 3 +++
 docs/_data/project.yml | 9 ++++-----
 5 files changed, 14 insertions(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index da68499df9..b4f9cd480d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,8 @@ Updates should follow the [Keep a CHANGELOG](https://keepachangelog.com/) princi
 
 ## [Unreleased][unreleased]
 
+## [2.5.0] - 2024-07-22
+
 ### Added
 
 - The `AttributesExtension` now supports attributes without values (#985, #986)
@@ -605,7 +607,8 @@ No changes were introduced since the previous release.
     - Alternative 1: Use `CommonMarkConverter` or `GithubFlavoredMarkdownConverter` if you don't need to customize the environment
     - Alternative 2: Instantiate a new `Environment` and add the necessary extensions yourself
 
-[unreleased]: https://github.com/thephpleague/commonmark/compare/2.4.4...main
+[unreleased]: https://github.com/thephpleague/commonmark/compare/2.5.0....main
+[2.5.0]: https://github.com/thephpleague/commonmark/compare/2.4.4...2.5.0
 [2.4.4]: https://github.com/thephpleague/commonmark/compare/2.4.3...2.4.4
 [2.4.3]: https://github.com/thephpleague/commonmark/compare/2.4.2...2.4.3
 [2.4.2]: https://github.com/thephpleague/commonmark/compare/2.4.1...2.4.2
diff --git a/composer.json b/composer.json
index 184aa96d02..0dd28291b2 100644
--- a/composer.json
+++ b/composer.json
@@ -112,7 +112,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-main": "2.5-dev"
+            "dev-main": "2.6-dev"
         }
     },
     "config": {
diff --git a/docs/2.5/upgrading.md b/docs/2.5/upgrading.md
index 7c29e65791..6cc089334f 100644
--- a/docs/2.5/upgrading.md
+++ b/docs/2.5/upgrading.md
@@ -6,3 +6,5 @@ redirect_from: /upgrading/
 ---
 
 # Upgrading from 2.4 to 2.5
+
+These are no significant changes since 2.4.
diff --git a/docs/_data/menu.yml b/docs/_data/menu.yml
index 6c6699d4b9..c854af521b 100644
--- a/docs/_data/menu.yml
+++ b/docs/_data/menu.yml
@@ -453,6 +453,9 @@ version:
 upgrading:
     Upgrading Guide:
         Release Notes: '/releases/'
+        From 2.4 to 2.5: '/2.5/upgrading'
+        From 2.3 to 2.4: '/2.4/upgrading'
+        From 2.2 to 2.3: '/2.3/upgrading'
         From 2.1 to 2.2: '/2.2/upgrading'
         From 2.0 to 2.1: '/2.1/upgrading'
         From 1.6 to 2.0: '/2.0/upgrading'
diff --git a/docs/_data/project.yml b/docs/_data/project.yml
index f5d5dfdace..44a3b290f6 100644
--- a/docs/_data/project.yml
+++ b/docs/_data/project.yml
@@ -4,18 +4,17 @@ description: PHP Markdown parser featuring support for CommonMark, GFM, and cust
 site_title: CommonMark for PHP
 google_analytics_tracking_id: UA-137970568-1
 repository: commonmark
-default_version: '2.4'
+default_version: '2.5'
 releases:
-  next:
+  current:
     '2.5':
       documentation_link: '/2.5/'
-  current:
+  previous:
     '2.4':
       documentation_link: '/2.4/'
-  previous:
+  legacy:
     '2.3':
       documentation_link: '/2.3/'
-  legacy:
     '2.2':
       documentation_link: '/2.2/'
     '2.1':