From e85bb28498ac35c91768057cbfac9e34dbee3403 Mon Sep 17 00:00:00 2001
From: Zack Spear <hi@zackspear.com>
Date: Tue, 7 Jan 2025 11:40:36 -0800
Subject: [PATCH] refactor: os version links to external docs

---
 web/components/HeaderOsVersion.ce.vue | 13 +++++++------
 web/helpers/urls.ts                   | 12 ++++++++++++
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/web/components/HeaderOsVersion.ce.vue b/web/components/HeaderOsVersion.ce.vue
index 1335ad202..c96b33573 100644
--- a/web/components/HeaderOsVersion.ce.vue
+++ b/web/components/HeaderOsVersion.ce.vue
@@ -10,7 +10,7 @@ import { useI18n } from 'vue-i18n';
 import 'tailwindcss/tailwind.css';
 import '~/assets/main.css';
 
-import { WEBGUI_TOOLS_DOWNGRADE, WEBGUI_TOOLS_UPDATE } from '~/helpers/urls';
+import { getReleaseNotesUrl, WEBGUI_TOOLS_DOWNGRADE, WEBGUI_TOOLS_UPDATE } from '~/helpers/urls';
 import { useServerStore } from '~/store/server';
 import { useUpdateOsStore } from '~/store/updateOs';
 import { useUpdateOsActionsStore } from '~/store/updateOsActions';
@@ -70,22 +70,23 @@ const updateOsStatus = computed(() => {
 
 <template>
   <div class="flex flex-row justify-start gap-x-4px">
-    <button
+    <a
       class="group leading-none"
       :title="t('View release notes')"
-      @click="updateOsActionsStore.viewReleaseNotes(t('{0} Release Notes', [osVersion]))"
+      :href="getReleaseNotesUrl(osVersion).toString()"
+      target="_blank"
+      rel="noopener"
     >
       <UiBadge
         color="custom"
         :icon="InformationCircleIcon"
-        icon-styles="text-gamma"
+        icon-styles="text-header-text-secondary"
         size="14px"
         class="text-gamma group-hover:text-orange-dark group-focus:text-orange-dark group-hover:underline group-focus:underline"
       >
         {{ osVersion }}
       </UiBadge>
-    </button>
-
+    </a>
     <component
       :is="updateOsStatus.href ? 'a' : 'button'"
       v-if="updateOsStatus"
diff --git a/web/helpers/urls.ts b/web/helpers/urls.ts
index 6d2de6382..dfb110bb7 100644
--- a/web/helpers/urls.ts
+++ b/web/helpers/urls.ts
@@ -24,6 +24,17 @@ const WEBGUI_TOOLS_UPDATE = new URL('/Tools/Update', WEBGUI);
 const OS_RELEASES = new URL(import.meta.env.VITE_OS_RELEASES ?? 'https://releases.unraid.net/os');
 
 const DOCS_RELEASE_NOTES = new URL('/go/release-notes/', DOCS);
+
+/**
+ * @param version - An Unraid OS version string (x.x.x-suffix). 
+ *   Suffix indicates special releases, such as RCs or betas.
+ * @returns A URL object pointing to the release notes for the specified Unraid OS version.
+ */
+const getReleaseNotesUrl = (version: string): URL => {
+  const osVersion = version.split('-')[0];
+  return new URL(`/unraid-os/release-notes/${osVersion}`, DOCS);
+}
+
 const DOCS_REGISTRATION_LICENSING = new URL('/go/faq-licensing/', DOCS);
 const DOCS_REGISTRATION_REPLACE_KEY = new URL('/go/changing-the-flash-device/', DOCS);
 
@@ -43,6 +54,7 @@ export {
   OS_RELEASES,
   DOCS,
   DOCS_RELEASE_NOTES,
+  getReleaseNotesUrl,
   DOCS_REGISTRATION_LICENSING,
   DOCS_REGISTRATION_REPLACE_KEY,
   WEBGUI,