Skip to content

Conversation

@jake-mahon-netwrix
Copy link
Contributor

Summary

  • Remove redundant kb/ prefix from all 18 KB index file slugs
  • Fixes broken KB navigation links by correcting Docusaurus routing
  • Resolves 404 errors for KB parent folder links across the documentation

Root Cause Analysis

The Problem:

  • KB plugin has routeBasePath: 'docs/kb'
  • KB index files had slug: kb/productname
  • Docusaurus URL generation: routeBasePath + slug = docs/kb + kb/productname = /docs/kb/kb/productname
  • generateKBSidebar() generates: /docs/kb/productname
  • MISMATCH: Links pointed to non-existent routes

The Fix:

  • Changed all slugs from kb/productnameproductname
  • Now Docusaurus serves: docs/kb + productname = /docs/kb/productname
  • generateKBSidebar() generates: /docs/kb/productname
  • MATCH: Links now work correctly

Files Changed

Fixed slug configuration in all 18 KB index files:

  • 1secure, accessanalyzer, accessinformationcenter, activitymonitor
  • auditor, dataclassification, directorymanager, endpointpolicymanager
  • endpointprotector, general, logtracker, passwordpolicyenforcer
  • passwordreset, privilegesecure, privilegesecurediscovery, recoveryad
  • threatmanager, threatprevention

Impact

This should resolve all broken KB index links reported in the build errors:

- Broken link on source page path = /docs/accessinformationcenter/11_6/:
   -> linking to /docs/kb/accessinformationcenter

🤖 Generated with Claude Code

Jake Mahon and others added 2 commits September 16, 2025 11:39
- Remove kb/ prefix from all KB index file slugs
- Prevents double routing: docs/kb + kb/productname -> docs/kb/kb/productname
- Now correctly generates: docs/kb + productname -> docs/kb/productname
- Matches generateKBSidebar() link generation for proper navigation

Root cause: KB plugin routeBasePath already includes 'docs/kb',
so slug should only contain the product name, not 'kb/productname'

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed remaining KB index files that still had kb/ prefix in slugs
- Now all 18 KB index files have clean slugs without redundant kb/ prefix
- Ensures proper routing: docs/kb + productname -> /docs/kb/productname
- Matches generateKBSidebar() link generation for seamless navigation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@james-s-anderson james-s-anderson merged commit e1194d7 into dev Sep 16, 2025
3 checks passed
@james-s-anderson james-s-anderson deleted the fix-kb-slug-double-prefix branch September 16, 2025 15:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants