From 5bcbf24b75a4eae263f14e85104c17bbb244d302 Mon Sep 17 00:00:00 2001
From: MM20 <15646950+MM2-0@users.noreply.github.com>
Date: Sat, 14 Mar 2026 18:17:54 +0100
Subject: [PATCH] (docs) Add plugin sdk changelogs

---
 .../v2.md => changelogs/v2.0.0.md}            |  6 +++-
 .../plugins/changelogs/v2.1.0.md              |  9 ++++++
 .../plugins/changelogs/v2.2.0.md              |  9 ++++++
 .../plugins/changelogs/v2.3.0.md              | 32 +++++++++++++++++++
 docs/docs/developer-guide/sidebar.ts          | 32 +++++++++++++------
 5 files changed, 77 insertions(+), 11 deletions(-)
 rename docs/docs/developer-guide/plugins/{migrations/v2.md => changelogs/v2.0.0.md} (90%)
 create mode 100644 docs/docs/developer-guide/plugins/changelogs/v2.1.0.md
 create mode 100644 docs/docs/developer-guide/plugins/changelogs/v2.2.0.md
 create mode 100644 docs/docs/developer-guide/plugins/changelogs/v2.3.0.md

diff --git a/docs/docs/developer-guide/plugins/migrations/v2.md b/docs/docs/developer-guide/plugins/changelogs/v2.0.0.md
similarity index 90%
rename from docs/docs/developer-guide/plugins/migrations/v2.md
rename to docs/docs/developer-guide/plugins/changelogs/v2.0.0.md
index 8ef9c856b..24c7d0b79 100644
--- a/docs/docs/developer-guide/plugins/migrations/v2.md
+++ b/docs/docs/developer-guide/plugins/changelogs/v2.0.0.md
@@ -1,4 +1,8 @@
-# Migrate from v1.x to v2.x
+# Version 2.0.0
+
+::: info Kvaesitso version
+**Version 1.31.0** (June 2024)
+:::
 
 Version 2.0.0 of the plugin SDK introduces some breaking changes:
 
diff --git a/docs/docs/developer-guide/plugins/changelogs/v2.1.0.md b/docs/docs/developer-guide/plugins/changelogs/v2.1.0.md
new file mode 100644
index 000000000..d10b25076
--- /dev/null
+++ b/docs/docs/developer-guide/plugins/changelogs/v2.1.0.md
@@ -0,0 +1,9 @@
+# Version 2.2.0
+
+::: info Kvaesitso version
+**Version 1.33.0** (August 2024)
+:::
+
+## Added calendar plugins
+
+- [Docs](/docs/developer-guide/plugins/plugin-types/calendar)
\ No newline at end of file
diff --git a/docs/docs/developer-guide/plugins/changelogs/v2.2.0.md b/docs/docs/developer-guide/plugins/changelogs/v2.2.0.md
new file mode 100644
index 000000000..f05ad45d0
--- /dev/null
+++ b/docs/docs/developer-guide/plugins/changelogs/v2.2.0.md
@@ -0,0 +1,9 @@
+# Version 2.2.0
+
+::: info Kvaesitso version
+**Version 1.35.3** (April 2025)
+:::
+
+## Added contact search plugins
+
+- [Docs](/docs/developer-guide/plugins/plugin-types/contact-search)
\ No newline at end of file
diff --git a/docs/docs/developer-guide/plugins/changelogs/v2.3.0.md b/docs/docs/developer-guide/plugins/changelogs/v2.3.0.md
new file mode 100644
index 000000000..d4a5f55df
--- /dev/null
+++ b/docs/docs/developer-guide/plugins/changelogs/v2.3.0.md
@@ -0,0 +1,32 @@
+# Version 2.3.0
+
+::: info Kvaesitso version
+**Version 1.40.0** (March 2026)
+:::
+
+## Renamed weather condition icons
+
+Some weather condition icons have been removed or renamed in order to better reflect their meaning.
+The
+following table lists the old names and their replacement:
+
+| Old name                    | Replacement                         |
+|-----------------------------|-------------------------------------|
+| `BrokenClouds`              | `PartlyCloudy`                      |
+| `HeavyThunderstorm`         | Removed, use `Thunder` instead      |
+| `HeavyThunderstormWithRain` | Removed, use `Thunderstorm` instead |
+| `ThunderstormWithRain`      | `Thunderstorm`                      |
+| `Showers`                   | `Rain`                              |
+| `Drizzle`                   | `LightRain`                         |
+| `MostlyCloudy`              | Removed, use`PartlyCloudy` instead  |
+| `Cloudy`                    | `Overcast`                          |
+| `Cold`                      | `ExtremeCold`                       |
+| `Hot`                       | `ExtremeHeat`                       |
+| `Storm`                     | `Wind`                              |
+
+Old names are still available, but they have been deprecated and should not be used. They will be
+removed in a later version.
+
+## Added UV index
+
+- `uvIndex` has been added to the weather `Forecast` type.
\ No newline at end of file
diff --git a/docs/docs/developer-guide/sidebar.ts b/docs/docs/developer-guide/sidebar.ts
index 93a529b2c..54d33e82c 100644
--- a/docs/docs/developer-guide/sidebar.ts
+++ b/docs/docs/developer-guide/sidebar.ts
@@ -97,21 +97,33 @@ export const DeveloperGuideSidebar: DefaultTheme.SidebarItem[] = [
         text: 'Access Control',
         link: '/docs/developer-guide/plugins/access-control',
       },
+      {
+        text: 'SDK Changelogs',
+        items: [
+          {
+            text: 'v2.3.0',
+            link: '/docs/developer-guide/plugins/changelogs/v2.3.0',
+          },
+          {
+            text: 'v2.2.0',
+            link: '/docs/developer-guide/plugins/changelogs/v2.2.0',
+          },
+          {
+            text: 'v2.1.0',
+            link: '/docs/developer-guide/plugins/changelogs/v2.1.0',
+          },
+          {
+            text: 'v2.0.0',
+            link: '/docs/developer-guide/plugins/changelogs/v2.0.0',
+          },
+
+        ],
+      },
       {
         text: 'Reference',
         link: '/reference/index.html',
         target: '_blank',
       },
-      {
-        text: 'Migrations',
-        items: [
-          {
-            text: 'Migrate to plugin SDK v2.x',
-            link: '/docs/developer-guide/plugins/migrations/v2',
-          },
-          ,
-        ],
-      },
     ],
   },
 ]