vitessio · frouioui · Mar 20, 2023 · Mar 2, 2023 · Mar 2, 2023 · Mar 2, 2023
@@ -17,7 +17,7 @@ jobs:
       - name: Release Notes label
         run: |
           if [[ "${{contains( github.event.pull_request.labels.*.name, 'release notes (needs details)')}}" == "true" ]]; then
-            echo The "release notes (needs details)" label is set. The changes made in this Pull Request need to be documented in the release notes summary "('./doc/releasenotes/16_0_0_summary.md')". Once documented, the "release notes (needs details)" label can be removed.
+            echo The "release notes (needs details)" label is set. The changes made in this Pull Request need to be documented in the release notes summary "('./changelog/17.0/17.0.0/17_0_0_summary.md')". Once documented, the "release notes (needs details)" label can be removed.
             exit 1
           fi
 

@@ -97,6 +97,9 @@ jobs:
             ci_config:
               - 'test/config.json'
               - '.github/workflows/static_checks_etc.yml'
+            release_notes:
+              - 'changelog/**'
+              - './go/tools/releases/**'
 
       - name: Set up Go
         if: steps.skip-workflow.outputs.skip-workflow == 'false' && (steps.changes.outputs.go_files == 'true' || steps.changes.outputs.parser_changes == 'true' || steps.changes.outputs.proto_changes == 'true')
@@ -206,3 +209,16 @@ jobs:
         if: steps.skip-workflow.outputs.skip-workflow == 'false' && (steps.changes.outputs.go_files == 'true' || steps.changes.outputs.ci_config == 'true')
         run: |
           go run ./go/tools/ci-config/main.go || exit 1
+
+      - name: Check changelog
+        if: steps.skip-workflow.outputs.skip-workflow == 'false' && steps.changes.outputs.release_notes == 'true'
+        run: |
+          set -e
+          go run ./go/tools/releases/releases.go
+          output=$(git status -s)
+          if [ -z "${output}" ]; then
+            exit 0
+          fi
+          echo 'We wish to maintain a consistent changelog directory, please run `go run ./go/tools/releases/releases.go`, commit and push again.'
+          echo 'Running `go run ./go/tools/releases/releases.go` on CI yields the following changes:'
+          echo "$output"
@@ -70,7 +70,7 @@ _test/
 /vendor/*/
 
 # release folder
-releases
+/releases/
 
 # Local examples
 /examples/local/vtdataroot

diff --git a/doc/releasenotes/10_0_0_release_notes.md → ...gelog/10.0/10.0.0/10_0_0_release_notes.md b/doc/releasenotes/10_0_0_release_notes.md → ...gelog/10.0/10.0.0/10_0_0_release_notes.md
diff --git a/doc/releasenotes/10_0_1_release_notes.md → ...gelog/10.0/10.0.1/10_0_1_release_notes.md b/doc/releasenotes/10_0_1_release_notes.md → ...gelog/10.0/10.0.1/10_0_1_release_notes.md
diff --git a/doc/releasenotes/10_0_2_release_notes.md → ...gelog/10.0/10.0.2/10_0_2_release_notes.md b/doc/releasenotes/10_0_2_release_notes.md → ...gelog/10.0/10.0.2/10_0_2_release_notes.md
diff --git a/doc/releasenotes/10_0_3_release_notes.md → ...gelog/10.0/10.0.3/10_0_3_release_notes.md b/doc/releasenotes/10_0_3_release_notes.md → ...gelog/10.0/10.0.3/10_0_3_release_notes.md
diff --git a/doc/releasenotes/10_0_3_summary.md → changelog/10.0/10.0.3/10_0_3_summary.md b/doc/releasenotes/10_0_3_summary.md → changelog/10.0/10.0.3/10_0_3_summary.md
diff --git a/doc/releasenotes/10_0_4_release_notes.md → ...gelog/10.0/10.0.4/10_0_4_release_notes.md b/doc/releasenotes/10_0_4_release_notes.md → ...gelog/10.0/10.0.4/10_0_4_release_notes.md
diff --git a/doc/releasenotes/10_0_4_summary.md → changelog/10.0/10.0.4/10_0_4_summary.md b/doc/releasenotes/10_0_4_summary.md → changelog/10.0/10.0.4/10_0_4_summary.md
diff --git a/doc/releasenotes/10_0_5_release_notes.md → ...gelog/10.0/10.0.5/10_0_5_release_notes.md b/doc/releasenotes/10_0_5_release_notes.md → ...gelog/10.0/10.0.5/10_0_5_release_notes.md
diff --git a/doc/releasenotes/10_0_5_summary.md → changelog/10.0/10.0.5/10_0_5_summary.md b/doc/releasenotes/10_0_5_summary.md → changelog/10.0/10.0.5/10_0_5_summary.md
@@ -0,0 +1,18 @@
+## v10.0
+* **[10.0.5](10.0.5)**
+	* [Release Notes](10.0.5/10_0_5_release_notes.md)
+
+* **[10.0.4](10.0.4)**
+	* [Release Notes](10.0.4/10_0_4_release_notes.md)
+
+* **[10.0.3](10.0.3)**
+	* [Release Notes](10.0.3/10_0_3_release_notes.md)
+
+* **[10.0.2](10.0.2)**
+	* [Release Notes](10.0.2/10_0_2_release_notes.md)
+
+* **[10.0.1](10.0.1)**
+	* [Release Notes](10.0.1/10_0_1_release_notes.md)
+
+* **[10.0.0](10.0.0)**
+	* [Release Notes](10.0.0/10_0_0_release_notes.md)
diff --git a/doc/releasenotes/11_0_0_release_notes.md → ...gelog/11.0/11.0.0/11_0_0_release_notes.md b/doc/releasenotes/11_0_0_release_notes.md → ...gelog/11.0/11.0.0/11_0_0_release_notes.md
diff --git a/doc/releasenotes/11_0_1_release_notes.md → ...gelog/11.0/11.0.1/11_0_1_release_notes.md b/doc/releasenotes/11_0_1_release_notes.md → ...gelog/11.0/11.0.1/11_0_1_release_notes.md
diff --git a/doc/releasenotes/11_0_2_release_notes.md → ...gelog/11.0/11.0.2/11_0_2_release_notes.md b/doc/releasenotes/11_0_2_release_notes.md → ...gelog/11.0/11.0.2/11_0_2_release_notes.md
diff --git a/doc/releasenotes/11_0_2_summary.md → changelog/11.0/11.0.2/11_0_2_summary.md b/doc/releasenotes/11_0_2_summary.md → changelog/11.0/11.0.2/11_0_2_summary.md
diff --git a/doc/releasenotes/11_0_3_release_notes.md → ...gelog/11.0/11.0.3/11_0_3_release_notes.md b/doc/releasenotes/11_0_3_release_notes.md → ...gelog/11.0/11.0.3/11_0_3_release_notes.md
diff --git a/doc/releasenotes/11_0_3_summary.md → changelog/11.0/11.0.3/11_0_3_summary.md b/doc/releasenotes/11_0_3_summary.md → changelog/11.0/11.0.3/11_0_3_summary.md
diff --git a/doc/releasenotes/11_0_4_release_notes.md → ...gelog/11.0/11.0.4/11_0_4_release_notes.md b/doc/releasenotes/11_0_4_release_notes.md → ...gelog/11.0/11.0.4/11_0_4_release_notes.md
diff --git a/doc/releasenotes/11_0_4_summary.md → changelog/11.0/11.0.4/11_0_4_summary.md b/doc/releasenotes/11_0_4_summary.md → changelog/11.0/11.0.4/11_0_4_summary.md
@@ -0,0 +1,15 @@
+## v11.0
+* **[11.0.4](11.0.4)**
+	* [Release Notes](11.0.4/11_0_4_release_notes.md)
+
+* **[11.0.3](11.0.3)**
+	* [Release Notes](11.0.3/11_0_3_release_notes.md)
+
+* **[11.0.2](11.0.2)**
+	* [Release Notes](11.0.2/11_0_2_release_notes.md)
+
+* **[11.0.1](11.0.1)**
+	* [Release Notes](11.0.1/11_0_1_release_notes.md)
+
+* **[11.0.0](11.0.0)**
+	* [Release Notes](11.0.0/11_0_0_release_notes.md)
diff --git a/doc/releasenotes/12_0_0_release_notes.md → ...gelog/12.0/12.0.0/12_0_0_release_notes.md b/doc/releasenotes/12_0_0_release_notes.md → ...gelog/12.0/12.0.0/12_0_0_release_notes.md
diff --git a/doc/releasenotes/12_0_0_summary.md → changelog/12.0/12.0.0/12_0_0_summary.md b/doc/releasenotes/12_0_0_summary.md → changelog/12.0/12.0.0/12_0_0_summary.md
diff --git a/doc/releasenotes/12_0_1_release_notes.md → ...gelog/12.0/12.0.1/12_0_1_release_notes.md b/doc/releasenotes/12_0_1_release_notes.md → ...gelog/12.0/12.0.1/12_0_1_release_notes.md
diff --git a/doc/releasenotes/12_0_1_summary.md → changelog/12.0/12.0.1/12_0_1_summary.md b/doc/releasenotes/12_0_1_summary.md → changelog/12.0/12.0.1/12_0_1_summary.md
diff --git a/doc/releasenotes/12_0_2_release_notes.md → ...gelog/12.0/12.0.2/12_0_2_release_notes.md b/doc/releasenotes/12_0_2_release_notes.md → ...gelog/12.0/12.0.2/12_0_2_release_notes.md
diff --git a/doc/releasenotes/12_0_2_summary.md → changelog/12.0/12.0.2/12_0_2_summary.md b/doc/releasenotes/12_0_2_summary.md → changelog/12.0/12.0.2/12_0_2_summary.md
diff --git a/doc/releasenotes/12_0_3_release_notes.md → ...gelog/12.0/12.0.3/12_0_3_release_notes.md b/doc/releasenotes/12_0_3_release_notes.md → ...gelog/12.0/12.0.3/12_0_3_release_notes.md
diff --git a/doc/releasenotes/12_0_3_summary.md → changelog/12.0/12.0.3/12_0_3_summary.md b/doc/releasenotes/12_0_3_summary.md → changelog/12.0/12.0.3/12_0_3_summary.md
diff --git a/doc/releasenotes/12_0_4_release_notes.md → ...gelog/12.0/12.0.4/12_0_4_release_notes.md b/doc/releasenotes/12_0_4_release_notes.md → ...gelog/12.0/12.0.4/12_0_4_release_notes.md
diff --git a/doc/releasenotes/12_0_5_changelog.md → changelog/12.0/12.0.5/12_0_5_changelog.md b/doc/releasenotes/12_0_5_changelog.md → changelog/12.0/12.0.5/12_0_5_changelog.md
diff --git a/doc/releasenotes/12_0_5_release_notes.md → ...gelog/12.0/12.0.5/12_0_5_release_notes.md b/doc/releasenotes/12_0_5_release_notes.md → ...gelog/12.0/12.0.5/12_0_5_release_notes.md
@@ -9,7 +9,7 @@ Below is a summary of this patch release. You can learn more [here](https://go.d
 
 > go1.17.12 (released 2022-07-12) includes security fixes to the compress/gzip, encoding/gob, encoding/xml, go/parser, io/fs, net/http, and path/filepath packages, as well as bug fixes to the compiler, the go command, the runtime, and the runtime/metrics package. [See the Go 1.17.12 milestone](https://github.com/golang/go/issues?q=milestone%3AGo1.17.12+label%3ACherryPickApproved) on our issue tracker for details.
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/12_0_5_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/12.0/12.0.5/12_0_5_changelog.md).
 
 The release includes 7 commits (excluding merges)
 

diff --git a/doc/releasenotes/12_0_6_changelog.md → changelog/12.0/12.0.6/12_0_6_changelog.md b/doc/releasenotes/12_0_6_changelog.md → changelog/12.0/12.0.6/12_0_6_changelog.md
diff --git a/doc/releasenotes/12_0_6_release_notes.md → ...gelog/12.0/12.0.6/12_0_6_release_notes.md b/doc/releasenotes/12_0_6_release_notes.md → ...gelog/12.0/12.0.6/12_0_6_release_notes.md
@@ -15,7 +15,7 @@ This change is documented on our website [here](https://vitess.io/docs/12.0/over
 
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/12_0_6_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/12.0/12.0.6/12_0_6_changelog.md).
 
 The release includes 11 commits (excluding merges)
 

diff --git a/doc/releasenotes/12_0_6_summary.md → changelog/12.0/12.0.6/12_0_6_summary.md b/doc/releasenotes/12_0_6_summary.md → changelog/12.0/12.0.6/12_0_6_summary.md
@@ -0,0 +1,23 @@
+## v12.0
+* **[12.0.6](12.0.6)**
+	* [Changelog](12.0.6/12_0_6_changelog.md)
+	* [Release Notes](12.0.6/12_0_6_release_notes.md)
+
+* **[12.0.5](12.0.5)**
+	* [Changelog](12.0.5/12_0_5_changelog.md)
+	* [Release Notes](12.0.5/12_0_5_release_notes.md)
+
+* **[12.0.4](12.0.4)**
+	* [Release Notes](12.0.4/12_0_4_release_notes.md)
+
+* **[12.0.3](12.0.3)**
+	* [Release Notes](12.0.3/12_0_3_release_notes.md)
+
+* **[12.0.2](12.0.2)**
+	* [Release Notes](12.0.2/12_0_2_release_notes.md)
+
+* **[12.0.1](12.0.1)**
+	* [Release Notes](12.0.1/12_0_1_release_notes.md)
+
+* **[12.0.0](12.0.0)**
+	* [Release Notes](12.0.0/12_0_0_release_notes.md)
diff --git a/doc/releasenotes/13_0_0_release_notes.md → ...gelog/13.0/13.0.0/13_0_0_release_notes.md b/doc/releasenotes/13_0_0_release_notes.md → ...gelog/13.0/13.0.0/13_0_0_release_notes.md
diff --git a/doc/releasenotes/13_0_0_summary.md → changelog/13.0/13.0.0/13_0_0_summary.md b/doc/releasenotes/13_0_0_summary.md → changelog/13.0/13.0.0/13_0_0_summary.md
diff --git a/doc/releasenotes/13_0_1_release_notes.md → ...gelog/13.0/13.0.1/13_0_1_release_notes.md b/doc/releasenotes/13_0_1_release_notes.md → ...gelog/13.0/13.0.1/13_0_1_release_notes.md
diff --git a/doc/releasenotes/13_0_2_changelog.md → changelog/13.0/13.0.2/13_0_2_changelog.md b/doc/releasenotes/13_0_2_changelog.md → changelog/13.0/13.0.2/13_0_2_changelog.md
diff --git a/doc/releasenotes/13_0_2_release_notes.md → ...gelog/13.0/13.0.2/13_0_2_release_notes.md b/doc/releasenotes/13_0_2_release_notes.md → ...gelog/13.0/13.0.2/13_0_2_release_notes.md
@@ -9,7 +9,7 @@ Below is a summary of this patch release. You can learn more [here](https://go.d
 
 > go1.17.12 (released 2022-07-12) includes security fixes to the compress/gzip, encoding/gob, encoding/xml, go/parser, io/fs, net/http, and path/filepath packages, as well as bug fixes to the compiler, the go command, the runtime, and the runtime/metrics package. [See the Go 1.17.12 milestone](https://github.com/golang/go/issues?q=milestone%3AGo1.17.12+label%3ACherryPickApproved) on our issue tracker for details.
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/13_0_2_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/13.0/13.0.2/13_0_2_changelog.md).
 The release includes 28 commits (excluding merges)
 
 Thanks to all our contributors: @GuptaManan100, @aquarapid, @frouioui, @harshit-gangal, @mattlord, @rohit-nayak-ps, @systay, @vitess-bot[bot], @vmg
diff --git a/doc/releasenotes/13_0_2_summary.md → changelog/13.0/13.0.2/13_0_2_summary.md b/doc/releasenotes/13_0_2_summary.md → changelog/13.0/13.0.2/13_0_2_summary.md
diff --git a/doc/releasenotes/13_0_3_changelog.md → changelog/13.0/13.0.3/13_0_3_changelog.md b/doc/releasenotes/13_0_3_changelog.md → changelog/13.0/13.0.3/13_0_3_changelog.md
diff --git a/doc/releasenotes/13_0_3_release_notes.md → ...gelog/13.0/13.0.3/13_0_3_release_notes.md b/doc/releasenotes/13_0_3_release_notes.md → ...gelog/13.0/13.0.3/13_0_3_release_notes.md
@@ -15,7 +15,7 @@ This change is documented on our website [here](https://vitess.io/docs/13.0/over
 
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/13_0_3_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/13.0/13.0.3/13_0_3_changelog.md).
 
 The release includes 17 commits(excluding merges)
 

diff --git a/doc/releasenotes/13_0_3_summary.md → changelog/13.0/13.0.3/13_0_3_summary.md b/doc/releasenotes/13_0_3_summary.md → changelog/13.0/13.0.3/13_0_3_summary.md
@@ -0,0 +1,14 @@
+## v13.0
+* **[13.0.3](13.0.3)**
+	* [Changelog](13.0.3/13_0_3_changelog.md)
+	* [Release Notes](13.0.3/13_0_3_release_notes.md)
+
+* **[13.0.2](13.0.2)**
+	* [Changelog](13.0.2/13_0_2_changelog.md)
+	* [Release Notes](13.0.2/13_0_2_release_notes.md)
+
+* **[13.0.1](13.0.1)**
+	* [Release Notes](13.0.1/13_0_1_release_notes.md)
+
+* **[13.0.0](13.0.0)**
+	* [Release Notes](13.0.0/13_0_0_release_notes.md)
diff --git a/doc/releasenotes/14_0_0_changelog.md → changelog/14.0/14.0.0/14_0_0_changelog.md b/doc/releasenotes/14_0_0_changelog.md → changelog/14.0/14.0.0/14_0_0_changelog.md
diff --git a/doc/releasenotes/14_0_0_release_notes.md → ...gelog/14.0/14.0.0/14_0_0_release_notes.md b/doc/releasenotes/14_0_0_release_notes.md → ...gelog/14.0/14.0.0/14_0_0_release_notes.md
@@ -319,7 +319,7 @@ Work has gone into making the advisory locks (`get_lock()`, `release_lock()`, et
 A long time ago, the sharding column and type were specified at the keyspace level. This syntax is now deprecated and will be removed in v15.
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/14_0_0_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/14.0/14.0.0/14_0_0_changelog.md).
 
 The release includes 1101 commits (excluding merges)
 

diff --git a/doc/releasenotes/14_0_0_summary.md → changelog/14.0/14.0.0/14_0_0_summary.md b/doc/releasenotes/14_0_0_summary.md → changelog/14.0/14.0.0/14_0_0_summary.md
diff --git a/doc/releasenotes/14_0_1_changelog.md → changelog/14.0/14.0.1/14_0_1_changelog.md b/doc/releasenotes/14_0_1_changelog.md → changelog/14.0/14.0.1/14_0_1_changelog.md
diff --git a/doc/releasenotes/14_0_1_release_notes.md → ...gelog/14.0/14.0.1/14_0_1_release_notes.md b/doc/releasenotes/14_0_1_release_notes.md → ...gelog/14.0/14.0.1/14_0_1_release_notes.md
@@ -13,7 +13,7 @@ Below is a summary of this patch release. You can learn more [here](https://go.d
 
 > go1.18.4 (released 2022-07-12) includes security fixes to the compress/gzip, encoding/gob, encoding/xml, go/parser, io/fs, net/http, and path/filepath packages, as well as bug fixes to the compiler, the go command, the linker, the runtime, and the runtime/metrics package. [See the Go 1.18.4 milestone](https://github.com/golang/go/issues?q=milestone%3AGo1.18.4+label%3ACherryPickApproved) on our issue tracker for details.
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/14_0_1_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/14.0/14.0.1/14_0_1_changelog.md).
 
 The release includes 25 commits (excluding merges)
 

diff --git a/doc/releasenotes/14_0_1_summary.md → changelog/14.0/14.0.1/14_0_1_summary.md b/doc/releasenotes/14_0_1_summary.md → changelog/14.0/14.0.1/14_0_1_summary.md
diff --git a/doc/releasenotes/14_0_2_changelog.md → changelog/14.0/14.0.2/14_0_2_changelog.md b/doc/releasenotes/14_0_2_changelog.md → changelog/14.0/14.0.2/14_0_2_changelog.md
diff --git a/doc/releasenotes/14_0_2_release_notes.md → ...gelog/14.0/14.0.2/14_0_2_release_notes.md b/doc/releasenotes/14_0_2_release_notes.md → ...gelog/14.0/14.0.2/14_0_2_release_notes.md
@@ -18,7 +18,7 @@ Since the end-of-life of MariaDB 10.2, its Docker image is unavailable, and we d
 You can find more information on the list of supported databases on our documentation website, [here](https://vitess.io/docs/14.0/overview/supported-databases/).
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/14_0_2_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/14.0/14.0.2/14_0_2_changelog.md).
 
 The release includes 23 commits (excluding merges)
 

diff --git a/doc/releasenotes/14_0_2_summary.md → changelog/14.0/14.0.2/14_0_2_summary.md b/doc/releasenotes/14_0_2_summary.md → changelog/14.0/14.0.2/14_0_2_summary.md
diff --git a/doc/releasenotes/14_0_3_changelog.md → changelog/14.0/14.0.3/14_0_3_changelog.md b/doc/releasenotes/14_0_3_changelog.md → changelog/14.0/14.0.3/14_0_3_changelog.md
diff --git a/doc/releasenotes/14_0_3_release_notes.md → ...gelog/14.0/14.0.3/14_0_3_release_notes.md b/doc/releasenotes/14_0_3_release_notes.md → ...gelog/14.0/14.0.3/14_0_3_release_notes.md
@@ -12,7 +12,7 @@ This problem could be resolved by restarting the VTOrc so that it discovers all
 frequently, this posed a greater challenge, since some pods when evicted and rescheduled on a different node, would sometimes fail to be discovered by VTOrc.
 This has problem has been addressed in this patch by the fix https://github.com/vitessio/vitess/pull/10662.
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/14_0_3_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/14.0/14.0.3/14_0_3_changelog.md).
 
 The release includes 12 commits (excluding merges)
 

diff --git a/doc/releasenotes/14_0_3_summary.md → changelog/14.0/14.0.3/14_0_3_summary.md b/doc/releasenotes/14_0_3_summary.md → changelog/14.0/14.0.3/14_0_3_summary.md
diff --git a/doc/releasenotes/14_0_4_changelog.md → changelog/14.0/14.0.4/14_0_4_changelog.md b/doc/releasenotes/14_0_4_changelog.md → changelog/14.0/14.0.4/14_0_4_changelog.md
diff --git a/doc/releasenotes/14_0_4_release_notes.md → ...gelog/14.0/14.0.4/14_0_4_release_notes.md b/doc/releasenotes/14_0_4_release_notes.md → ...gelog/14.0/14.0.4/14_0_4_release_notes.md
@@ -14,7 +14,7 @@ Below is a summary of this patch release. You can learn more [here](https://go.d
 An issue in versions `<= v14.0.3` and `<= v15.0.0` that generated corrupted results for non-full-group-by queries with a JOIN
 is now fixed. The full issue can be found [here](https://github.com/vitessio/vitess/issues/11625), and its fix [here](https://github.com/vitessio/vitess/pull/11633).
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/14_0_4_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/14.0/14.0.4/14_0_4_changelog.md).
 
 The release includes 24 commits (excluding merges)
 

diff --git a/doc/releasenotes/14_0_4_summary.md → changelog/14.0/14.0.4/14_0_4_summary.md b/doc/releasenotes/14_0_4_summary.md → changelog/14.0/14.0.4/14_0_4_summary.md
@@ -0,0 +1,20 @@
+## v14.0
+* **[14.0.4](14.0.4)**
+	* [Changelog](14.0.4/14_0_4_changelog.md)
+	* [Release Notes](14.0.4/14_0_4_release_notes.md)
+
+* **[14.0.3](14.0.3)**
+	* [Changelog](14.0.3/14_0_3_changelog.md)
+	* [Release Notes](14.0.3/14_0_3_release_notes.md)
+
+* **[14.0.2](14.0.2)**
+	* [Changelog](14.0.2/14_0_2_changelog.md)
+	* [Release Notes](14.0.2/14_0_2_release_notes.md)
+
+* **[14.0.1](14.0.1)**
+	* [Changelog](14.0.1/14_0_1_changelog.md)
+	* [Release Notes](14.0.1/14_0_1_release_notes.md)
+
+* **[14.0.0](14.0.0)**
+	* [Changelog](14.0.0/14_0_0_changelog.md)
+	* [Release Notes](14.0.0/14_0_0_release_notes.md)
diff --git a/doc/releasenotes/15_0_0_changelog.md → changelog/15.0/15.0.0/15_0_0_changelog.md b/doc/releasenotes/15_0_0_changelog.md → changelog/15.0/15.0.0/15_0_0_changelog.md
diff --git a/doc/releasenotes/15_0_0_release_notes.md → ...gelog/15.0/15.0.0/15_0_0_release_notes.md b/doc/releasenotes/15_0_0_release_notes.md → ...gelog/15.0/15.0.0/15_0_0_release_notes.md
@@ -455,7 +455,7 @@ Below are the changes for each binary.
 - [zkctld](https://github.com/vitessio/vitess/blob/release-15.0/doc/flags/14.0-to-15.0-transition/zkctld.diff)
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/15_0_0_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/15.0/15.0.0/15_0_0_changelog.md).
 
 The release includes 595 commits (excluding merges)
 

diff --git a/doc/releasenotes/15_0_0_summary.md → changelog/15.0/15.0.0/15_0_0_summary.md b/doc/releasenotes/15_0_0_summary.md → changelog/15.0/15.0.0/15_0_0_summary.md
diff --git a/doc/releasenotes/15_0_1_changelog.md → changelog/15.0/15.0.1/15_0_1_changelog.md b/doc/releasenotes/15_0_1_changelog.md → changelog/15.0/15.0.1/15_0_1_changelog.md
diff --git a/doc/releasenotes/15_0_1_release_notes.md → ...gelog/15.0/15.0.1/15_0_1_release_notes.md b/doc/releasenotes/15_0_1_release_notes.md → ...gelog/15.0/15.0.1/15_0_1_release_notes.md
@@ -16,7 +16,7 @@ This issue is fixed in 15.0.1. The full issue can be found [here](https://github
 
 ------------
 
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/15_0_1_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/15.0/15.0.1/15_0_1_changelog.md).
 
 The release includes 25 commits (excluding merges)
 

diff --git a/doc/releasenotes/15_0_1_summary.md → changelog/15.0/15.0.1/15_0_1_summary.md b/doc/releasenotes/15_0_1_summary.md → changelog/15.0/15.0.1/15_0_1_summary.md
diff --git a/doc/releasenotes/15_0_2_changelog.md → changelog/15.0/15.0.2/15_0_2_changelog.md b/doc/releasenotes/15_0_2_changelog.md → changelog/15.0/15.0.2/15_0_2_changelog.md
diff --git a/doc/releasenotes/15_0_2_release_notes.md → ...gelog/15.0/15.0.2/15_0_2_release_notes.md b/doc/releasenotes/15_0_2_release_notes.md → ...gelog/15.0/15.0.2/15_0_2_release_notes.md
@@ -12,7 +12,7 @@ Below is a summary of this patch release. You can learn more [here](https://grou
 
 ------------
 
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/15_0_2_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/15.0/15.0.2/15_0_2_changelog.md).
 
 The release includes 14 commits (excluding merges)
 

diff --git a/doc/releasenotes/15_0_2_summary.md → changelog/15.0/15.0.2/15_0_2_summary.md b/doc/releasenotes/15_0_2_summary.md → changelog/15.0/15.0.2/15_0_2_summary.md
@@ -0,0 +1,12 @@
+## v15.0
+* **[15.0.2](15.0.2)**
+	* [Changelog](15.0.2/15_0_2_changelog.md)
+	* [Release Notes](15.0.2/15_0_2_release_notes.md)
+
+* **[15.0.1](15.0.1)**
+	* [Changelog](15.0.1/15_0_1_changelog.md)
+	* [Release Notes](15.0.1/15_0_1_release_notes.md)
+
+* **[15.0.0](15.0.0)**
+	* [Changelog](15.0.0/15_0_0_changelog.md)
+	* [Release Notes](15.0.0/15_0_0_release_notes.md)
diff --git a/doc/releasenotes/16_0_0_changelog.md → changelog/16.0/16.0.0/16_0_0_changelog.md b/doc/releasenotes/16_0_0_changelog.md → changelog/16.0/16.0.0/16_0_0_changelog.md
diff --git a/doc/releasenotes/16_0_0_release_notes.md → ...gelog/16.0/16.0.0/16_0_0_release_notes.md b/doc/releasenotes/16_0_0_release_notes.md → ...gelog/16.0/16.0.0/16_0_0_release_notes.md
@@ -525,7 +525,7 @@ The sidecar tables `local_metadata` and `shard_metadata` are no longer in use an
 part of this refactor. They were used previously for Orchestrator support, which has been superseded by `vtorc`.
 
 ------------
-The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/16_0_0_changelog.md).
+The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/16.0/16.0.0/16_0_0_changelog.md).
 
 The release includes 378 commits (excluding merges)
 

diff --git a/doc/releasenotes/16_0_0_summary.md → changelog/16.0/16.0.0/16_0_0_summary.md b/doc/releasenotes/16_0_0_summary.md → changelog/16.0/16.0.0/16_0_0_summary.md
@@ -0,0 +1,5 @@
+## v16.0
+The dedicated team for this release can be found [here](TEAM.md).
+* **[16.0.0](16.0.0)**
+	* [Changelog](16.0.0/16_0_0_changelog.md)
+	* [Release Notes](16.0.0/16_0_0_release_notes.md)
diff --git a/changelog/16.0/TEAM.md b/changelog/16.0/TEAM.md
@@ -0,0 +1,5 @@
+## Release Team for v16
+
+- **Lead:** Rameez Sajwani ([rsajwani](https://github.com/rsajwani)) rameez@planetscale.com
+- **Shadow:** Manan Gupta ([GuptaManan100](https://github.com/GuptaManan100)) manan@planetscale.com
+- **Mentor:** Florent Poinsard ([frouioui](https://github.com/frouioui)) florent@planetscale.com
diff --git a/doc/releasenotes/17_0_0_summary.md → changelog/17.0/17.0.0/17_0_0_summary.md b/doc/releasenotes/17_0_0_summary.md → changelog/17.0/17.0.0/17_0_0_summary.md
@@ -19,7 +19,7 @@
 
 #### <a id="vtgr-default-tls-version"/>Default TLS version changed for `vtgr`
 
-When using TLS with `vtgr`, we now default to TLS 1.2 if no other explicit version is configured. Configuration flags are provided to explicitly configure the minimum TLS version to be used. 
+When using TLS with `vtgr`, we now default to TLS 1.2 if no other explicit version is configured. Configuration flags are provided to explicitly configure the minimum TLS version to be used.
 
 #### <a id="dedicated-vtgate-prepare-stats"> Dedicated stats for VTGate Prepare operations
 
@@ -54,15 +54,15 @@ Prior to v17 the builtin Backup Engine does not use read buffering for restores,
 
 In v17 these defaults may be tuned with, respectively `--builtinbackup-file-read-buffer-size` and `--builtinbackup-file-write-buffer-size`.
 
- - `--builtinbackup-file-read-buffer-size`:  read files using an IO buffer of this many bytes. Golang defaults are used when set to 0.
- - `--builtinbackup-file-write-buffer-size`: write files using an IO buffer of this many bytes. Golang defaults are used when set to 0. (default 2097152)
+- `--builtinbackup-file-read-buffer-size`:  read files using an IO buffer of this many bytes. Golang defaults are used when set to 0.
+- `--builtinbackup-file-write-buffer-size`: write files using an IO buffer of this many bytes. Golang defaults are used when set to 0. (default 2097152)
 
 These flags are applicable to the following programs:
 
- - `vtbackup`
- - `vtctld`
- - `vttablet`
- - `vttestserver`
+- `vtbackup`
+- `vtctld`
+- `vttablet`
+- `vttestserver`
 
 ### <a id="new-stats"/> New stats
 
@@ -76,9 +76,9 @@ Metrics related to backup operations are available in both Vtbackup and VTTablet
 
 Depending on the Backup Engine and Backup Storage in-use, a backup may be a complex pipeline of operations, including but not limited to:
 
- * Reading files from disk.
- * Compressing files.
- * Uploading compress files to cloud object storage.
+* Reading files from disk.
+* Compressing files.
+* Uploading compress files to cloud object storage.
 
 These operations are counted and timed, and the number of bytes consumed or produced by each stage of the pipeline are counted as well.
 
@@ -90,9 +90,9 @@ Metrics related to restore operations are available in both Vtbackup and VTTable
 
 Depending on the Backup Engine and Backup Storage in-use, a restore may be a complex pipeline of operations, including but not limited to:
 
- * Downloading compressed files from cloud object storage.
- * Decompressing files.
- * Writing decompressed files to disk.
+* Downloading compressed files from cloud object storage.
+* Decompressing files.
+* Writing decompressed files to disk.
 
 These operations are counted and timed, and the number of bytes consumed or produced by each stage of the pipeline are counted as well.
 
@@ -179,10 +179,10 @@ _DurationByPhaseSeconds_ exports timings for these individual phases.
 
 Some notes to help understand these metrics:
 
- * `BackupBytes["BackupStorage.File.File:Write"]` measures how many bytes were read from disk by the `file` Backup Storage implementation during the backup phase.
- * `DurationByPhaseSeconds["CatchUpReplication"]` measures how long it took to catch-up replication after the restore phase.
- * `DurationByPhaseSeconds["RestoreLastBackup"]` measures to the duration of the restore phase.
- * `RestoreDurationNanoseconds["-.-.Restore"]` also measures to the duration of the restore phase.
+* `BackupBytes["BackupStorage.File.File:Write"]` measures how many bytes were read from disk by the `file` Backup Storage implementation during the backup phase.
+* `DurationByPhaseSeconds["CatchUpReplication"]` measures how long it took to catch-up replication after the restore phase.
+* `DurationByPhaseSeconds["RestoreLastBackup"]` measures to the duration of the restore phase.
+* `RestoreDurationNanoseconds["-.-.Restore"]` also measures to the duration of the restore phase.
 
 #### <a id="vttablet-error-count-with-code"/> VTTablet error count with error code
 

@@ -0,0 +1,3 @@
+## v17.0
+The dedicated team for this release can be found [here](TEAM.md).
+* **[17.0.0](17.0.0)**
diff --git a/changelog/17.0/TEAM.md b/changelog/17.0/TEAM.md
@@ -0,0 +1,5 @@
+## Release Team for v17
+
+- **Lead:** Manan Gupta ([GuptaManan100](https://github.com/GuptaManan100)) manan@planetscale.com
+- **Shadow:** Matt Lord ([mattlord](https://github.com/mattlord)) mlord@planetscale.com
+- **Mentor:** Florent Poinsard ([frouioui](https://github.com/frouioui)) florent@planetscale.com
diff --git a/doc/releasenotes/7_0_0_release_notes.md → changelog/7.0/7.0.0/7_0_0_release_notes.md b/doc/releasenotes/7_0_0_release_notes.md → changelog/7.0/7.0.0/7_0_0_release_notes.md
diff --git a/doc/releasenotes/7_0_1_release_notes.md → changelog/7.0/7.0.1/7_0_1_release_notes.md b/doc/releasenotes/7_0_1_release_notes.md → changelog/7.0/7.0.1/7_0_1_release_notes.md
diff --git a/doc/releasenotes/7_0_2_release_notes.md → changelog/7.0/7.0.2/7_0_2_release_notes.md b/doc/releasenotes/7_0_2_release_notes.md → changelog/7.0/7.0.2/7_0_2_release_notes.md
diff --git a/doc/releasenotes/7_0_3_release_notes.md → changelog/7.0/7.0.3/7_0_3_release_notes.md b/doc/releasenotes/7_0_3_release_notes.md → changelog/7.0/7.0.3/7_0_3_release_notes.md
@@ -0,0 +1,12 @@
+## v7.0
+* **[7.0.3](7.0.3)**
+	* [Release Notes](7.0.3/7_0_3_release_notes.md)
+
+* **[7.0.2](7.0.2)**
+	* [Release Notes](7.0.2/7_0_2_release_notes.md)
+
+* **[7.0.1](7.0.1)**
+	* [Release Notes](7.0.1/7_0_1_release_notes.md)
+
+* **[7.0.0](7.0.0)**
+	* [Release Notes](7.0.0/7_0_0_release_notes.md)
diff --git a/doc/releasenotes/8_0_0_release_notes.md → changelog/8.0/8.0.0/8_0_0_release_notes.md b/doc/releasenotes/8_0_0_release_notes.md → changelog/8.0/8.0.0/8_0_0_release_notes.md
@@ -0,0 +1,3 @@
+## v8.0
+* **[8.0.0](8.0.0)**
+	* [Release Notes](8.0.0/8_0_0_release_notes.md)
diff --git a/doc/releasenotes/9_0_0_release_notes.md → changelog/9.0/9.0.0/9_0_0_release_notes.md b/doc/releasenotes/9_0_0_release_notes.md → changelog/9.0/9.0.0/9_0_0_release_notes.md
diff --git a/doc/releasenotes/9_0_1_release_notes.md → changelog/9.0/9.0.1/9_0_1_release_notes.md b/doc/releasenotes/9_0_1_release_notes.md → changelog/9.0/9.0.1/9_0_1_release_notes.md
diff --git a/doc/releasenotes/9_0_2_release_notes.md → changelog/9.0/9.0.2/9_0_2_release_notes.md b/doc/releasenotes/9_0_2_release_notes.md → changelog/9.0/9.0.2/9_0_2_release_notes.md
@@ -0,0 +1,9 @@
+## v9.0
+* **[9.0.2](9.0.2)**
+	* [Release Notes](9.0.2/9_0_2_release_notes.md)
+
+* **[9.0.1](9.0.1)**
+	* [Release Notes](9.0.1/9_0_1_release_notes.md)
+
+* **[9.0.0](9.0.0)**
+	* [Release Notes](9.0.0/9_0_0_release_notes.md)
-Original file line number
+Diff line change
@@ Expand Up @@
     ------------
-    The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/doc/releasenotes/12_0_6_changelog.md).
+    The entire changelog for this release can be found [here](https://github.com/vitessio/vitess/blob/main/changelog/12.0/12.0.6/12_0_6_changelog.md).
     The release includes 11 commits (excluding merges)
@@ Expand Down @@