From fcda45422c5bb1fac5b1eb38c6ff6d46a84368a9 Mon Sep 17 00:00:00 2001
From: meelahme <jameelahmercer@gmail.com>
Date: Mon, 17 Nov 2025 11:12:07 -0800
Subject: [PATCH] fix: convert relative README links to full GitHub URLs

---
 .../influxdb3-plugins/port_to_docs.js         | 23 +++++++++++++++----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/helper-scripts/influxdb3-plugins/port_to_docs.js b/helper-scripts/influxdb3-plugins/port_to_docs.js
index 590b45b0f..32d5bce2f 100644
--- a/helper-scripts/influxdb3-plugins/port_to_docs.js
+++ b/helper-scripts/influxdb3-plugins/port_to_docs.js
@@ -39,23 +39,36 @@ function removeEmojiMetadata(content) {
  */
 function convertRelativeLinks(content, pluginName) {
   const baseUrl = `https://github.com/influxdata/influxdb3_plugins/blob/master/influxdata/${pluginName}/`;
+  const rootUrl = 'https://github.com/influxdata/influxdb3_plugins/blob/master/';
+
+  // Convert relative README links (../../README.md, ../README.md, etc.)
+  content = content.replace(
+    /\[([^\]]+)\]\((\.\.\/)+README\.md\)/g,
+    `[$1](${rootUrl}README.md)`
+  );
 
   // Convert TOML file links
   content = content.replace(
-    /\[([^\]]+\.toml)\]\(([^)]+\.toml)\)/g,
-    (match, linkText, linkPath) => `[${linkText}](${baseUrl}${linkPath})`
+    /\[([^\]]+\.toml)\]\(\.?\/?([^)]+\.toml)\)/g,
+    (match, linkText, linkPath) => {
+      const cleanPath = linkPath.replace(/^\.\//, '');
+      return `[${linkText}](${baseUrl}${cleanPath})`;
+    }
   );
 
   // Convert Python file links
   content = content.replace(
-    /\[([^\]]+\.py)\]\(([^)]+\.py)\)/g,
-    (match, linkText, linkPath) => `[${linkText}](${baseUrl}${linkPath})`
+    /\[([^\]]+\.py)\]\(\.?\/?([^)]+\.py)\)/g,
+    (match, linkText, linkPath) => {
+      const cleanPath = linkPath.replace(/^\.\//, '');
+      return `[${linkText}](${baseUrl}${cleanPath})`;
+    }
   );
 
   // Convert main README reference
   content = content.replace(
     '[influxdb3_plugins/README.md](/README.md)',
-    '[influxdb3_plugins/README.md](https://github.com/influxdata/influxdb3_plugins/blob/master/README.md)'
+    `[influxdb3_plugins/README.md](${rootUrl}README.md)`
   );
 
   return content;