From 8ae679ed3ff0cf1644434802f5b44c1ef1bbf436 Mon Sep 17 00:00:00 2001
From: wvandeun <wim@opsmill.com>
Date: Thu, 17 Oct 2024 13:54:50 +0200
Subject: [PATCH] add release notes to the documentation

---
 CHANGELOG.md                                  |  1 -
 .../release-notes/infrahub/release-0_16_4.mdx | 72 +++++++++++++++++++
 docs/sidebars.ts                              |  1 +
 3 files changed, 73 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/release-notes/infrahub/release-0_16_4.mdx

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b60c1c7cb..597e6655ad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,6 @@ This project uses [*towncrier*](https://towncrier.readthedocs.io/) and the chang
 
 - Fixed an issue on the UI where a new relationship was being added to the main branch instead of the current branch. ([#4598](https://github.com/opsmill/infrahub/issues/4598))
 
-
 ## [0.16.3](https://github.com/opsmill/infrahub/tree/v0.16.3) - 2024-10-10
 
 ### Removed
diff --git a/docs/docs/release-notes/infrahub/release-0_16_4.mdx b/docs/docs/release-notes/infrahub/release-0_16_4.mdx
new file mode 100644
index 0000000000..c1c69f1bf5
--- /dev/null
+++ b/docs/docs/release-notes/infrahub/release-0_16_4.mdx
@@ -0,0 +1,72 @@
+---
+title: Release 0.16.4
+---
+<table>
+  <tbody>
+    <tr>
+      <th>Release Number</th>
+      <td>0.16.4</td>
+    </tr>
+    <tr>
+      <th>Release Date</th>
+      <td>October 17th, 2024</td>
+    </tr>
+    <tr>
+      <th>Release Codename</th>
+      <td>Beta #5, Patch #4</td>
+    </tr>
+    <tr>
+      <th>Tag</th>
+      <td>[infrahub-v0.16.4](https://github.com/opsmill/infrahub/releases/tag/infrahub-v0.16.4)</td>
+    </tr>
+  </tbody>
+</table>
+
+# Release 0.16.4
+
+We are thrilled to announce the latest release of Infrahub, version *0.16.4*!
+
+This release focuses largely on bug fixes and is driven by our Beta Test users,
+and as always we greatly appreciate their feedback and time!
+
+## Main changes
+
+The complete list of changes can always be found in the `CHANGELOG.md` file in the Infrahub Git repository.
+
+### Fixed
+
+- Fixed an issue on the UI where a new relationship was being added to the main branch instead of the current branch. ([#4598](https://github.com/opsmill/infrahub/issues/4598))
+
+## Migration guide
+
+To migrate your instance of Infrahub to the latest version, please run the following commands and restart all instances of Infrahub.
+
+<!-- vale off -->
+```shell
+infrahub db migrate
+infrahub db update-core-schema
+```
+<!-- vale on -->
+
+> if you are running in docker these commands need to run from the container where Infrahub is installed
+
+### Migration of the demo instance
+
+If you are using the demo environment, you can migrate to the latest version with the following commands
+
+```shell
+invoke demo.stop
+invoke demo.build
+invoke demo.migrate
+invoke demo.start
+```
+
+If you don't want to keep your data, you can start a clean instance with the following command
+
+```shell
+invoke demo.destroy demo.build demo.start demo.load-infra-schema demo.load-infra-data
+```
+
+> All data will be lost, please make sure to backup everything you need before running this command.
+
+The repository https://github.com/opsmill/infrahub-demo-edge has also been updated, it's recommended to pull the latest changes into your fork.
diff --git a/docs/sidebars.ts b/docs/sidebars.ts
index 1ab485511a..8f1aa4fc80 100644
--- a/docs/sidebars.ts
+++ b/docs/sidebars.ts
@@ -308,6 +308,7 @@ const sidebars: SidebarsConfig = {
           },
           items: [
             // 'release-notes/infrahub/release-1_0-DRAFT',
+            'release-notes/infrahub/release-0_16_4',
             'release-notes/infrahub/release-0_16_3',
             'release-notes/infrahub/release-0_16_2',
             'release-notes/infrahub/release-0_16_1',