Merge pull request #875 from opsmill/fix/sidebar-cross-repo-paths

fix: make sidebar path detection work in both repos

Author: petercrocker

docs/sidebars/sidebar-utils.ts

@@ -1,3 +1,23 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Detects the base directory containing the docs content (python-sdk/, infrahubctl/, etc.).
+ *
+ * The sidebar files live in different locations depending on which repo they are in:
+ *   - infrahub-sdk-python: docs/sidebars/ → content is at docs/docs/
+ *   - infrahub-docs:       docs/           → content is at docs/docs-python-sdk/
+ *
+ * We detect the active layout by checking whether the SDK-repo content path exists.
+ */
+export function getDocsBaseDir(): string {
+  const sdkRepoDocsDir = join(__dirname, '..', 'docs');
+  if (existsSync(join(sdkRepoDocsDir, 'python-sdk'))) {
+    return sdkRepoDocsDir;
+  }
+  return join(__dirname, 'docs-python-sdk');
+}
+
 export function getCommandItems(files: string[], indexFile: string = 'infrahubctl.mdx'): string[] {
   return files
     .filter(file => file.endsWith('.mdx') && file !== indexFile)

docs/sidebars/sidebars-infrahubctl.ts

@@ -1,9 +1,9 @@
 import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
 import {readdirSync} from 'fs';
 import {join} from 'path';
-import {getCommandItems} from './sidebar-utils';
+import {getCommandItems, getDocsBaseDir} from './sidebar-utils';
 
-const docsDir = join(__dirname, '..', 'docs', 'infrahubctl');
+const docsDir = join(getDocsBaseDir(), 'infrahubctl');
 const commandItems = getCommandItems(readdirSync(docsDir));
 
 const sidebars: SidebarsConfig = {

docs/sidebars/sidebars-python-sdk.ts

@@ -1,9 +1,9 @@
 import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
 import { readdirSync } from 'fs';
 import { join } from 'path';
-import { getItemsWithOrder } from './sidebar-utils';
+import { getDocsBaseDir, getItemsWithOrder } from './sidebar-utils';
 
-const pythonSdkDocsDir = join(__dirname, '..', 'docs', 'python-sdk');
+const pythonSdkDocsDir = join(getDocsBaseDir(), 'python-sdk');
 
 const guidesItems = getItemsWithOrder(
   readdirSync(join(pythonSdkDocsDir, 'guides')),