Uh oh!
There was an error while loading. Please reload this page.
Add KB sidebar migration infrastructure with Access Analyzer pilot - #112
Merged
Conversation
added 5 commits
February 3, 2026 15:59
- Add special handling for unversioned products (version: 'current') to copy KB to root level (docs/[product]/kb/) instead of /current/ folder - Fixes: 1secure, endpointpolicymanager, endpointprotector, privilegesecurediscovery - Add recoveryforactivedirectory support with folder name mapping (recoveryad) - Standardize KB labels to 'Knowledge Base' across all products (directorymanager, auditor, changetracker, 1secure, endpointpolicymanager) - Remove duplicate /current/kb/ folders for unversioned products - Add missing _category_.json to 1secure/setup-and-configuration for proper ordering - Convert copy script from .js to .mjs with ES modules - Generate updated kb_allowlist.json with all 19 products - Add tracking files for migration reference (kb-categories-inventory.txt, kb-sidebars-to-migrate.txt)
- Update copy script to auto-generate category files with generated-index configuration - All KB category folders now display icon grid view when clicked (278 categories updated) - Add add-generated-index.mjs script for batch updating category files - Improve Threat Prevention scripts README with prominent disclaimer and clear KB article references - Regenerate kb_allowlist.json with updated configuration
- Add MIGRATED_PRODUCTS array to copy script for gradual rollout - Add accessanalyzer to migrated products list - Remove KB folders from Phase 1 testing - Script now only processes products in migration list
…-autogen-all-products
- Only Access Analyzer is migrated to new autogenerated KB - Allowlist reflects products processed by copy script
Uh oh!
There was an error while loading. Please reload this page.
- Use atomic 'wx' flag instead of check-then-write pattern - Prevents theoretical race condition in category file generation - No functional change, same behavior - Resolves CodeQL security alert
hilram7
commented
Feb 5, 2026
CollaboratorAuthor
Hi @netwrix/1secure-docs and @netwrix/kb-docs, I need approval for this script that will start implementing the KB sidebar persistence fix across products. I made one small wording change to a sidebar label for 1Secure, so that is why this PR requires @netwrix/1secure-docs approval. Let me know if you have any questions. |
james-s-anderson
approved these changes
Feb 5, 2026
jake-mahon-netwrix
approved these changes
Feb 5, 2026
Uh oh!
There was an error while loading. Please reload this page.
This was referenced Feb 5, 2026
This was referenced Feb 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements infrastructure for gradual migration of Knowledge Base sidebars from manual
generateKBSidebar()to Docusaurus autogenerated sidebars. Access Analyzer (NAA) is included as the pilot product to demonstrate the new approach.Problem Being Solved
Currently, KB articles use a manual sidebar generation function that:
docs/kb/[product]/source directories/docs/kb/)This creates maintenance challenges and inconsistent UX. The new approach:
Changes Made
Infrastructure
MIGRATED_PRODUCTSarray to control gradual rolloutversion: 'current'Access Analyzer (Pilot Migration)
MIGRATED_PRODUCTSlistSource KB Improvements
Testing
Rollout Plan
generateKBSidebar.jsNote on 1secure Changes
This PR includes a minor, non-breaking label change to 1secure's KB category file as part of standardizing KB labels across all products. This is why @netwrix/1secure-docs is automatically added as a reviewer. The change does not affect 1secure's functionality or content, only improves label consistency.
Files Changed
scripts/copy-kb-to-versions.mjs: Migration control systemkb_allowlist.json: Generated file (tracks migrated products)docs/kb/*/_category_.json: Label standardization (1secure, auditor, changetracker, directorymanager, endpointpolicymanager)