some comments

Author: jdv

crowdsec-docs/docusaurus.config.ts

@@ -56,6 +56,9 @@ const ACADEMY_URL = `https://academy.crowdsec.net/courses?${
 	process.env.NODE_ENV === "production" ? "utm_source=docs&utm_medium=menu&utm_campaign=top-menu&utm_id=academydocs" : ""
 }`;
 
+/** IF you make significant changes to the nav bar or side bars 
+ * make sure to have proper mapping in crowdsec-docs/src/sectionMap.ts */
+ 
 const NAVBAR_ITEMS: NavbarItem[] = [
 	{
 		label: "Security Stack",

crowdsec-docs/sidebars.ts

@@ -2,6 +2,9 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
 
 type SidebarConfig = SidebarsConfig[string];
 
+/** IF you make significant changes to the nav bar or side bars 
+ * make sure to have proper mapping in crowdsec-docs/src/sectionMap.ts */
+ 
 const sidebarsConfig: SidebarConfig = {
 	// By default, Docusaurus generates a sidebar from the docs folder structure
 	//tutorialSidebar: [{type: 'autogenerated', dirName: '.'}],

crowdsec-docs/sidebarsUnversioned.ts

@@ -2,6 +2,9 @@ import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
 
 type SidebarConfig = SidebarsConfig[string];
 
+/** IF you make significant changes to the nav bar or side bars 
+ * make sure to have proper mapping in crowdsec-docs/src/sectionMap.ts */
+ 
 const sidebarsUnversionedConfig: SidebarConfig = {
 	ctiApiSidebar: [
 		{

crowdsec-docs/src/theme/DocRoot/Layout/index.tsx

@@ -1,3 +1,15 @@
+ /**
+ * CrowdSec Made Swizzled override of @docusaurus/theme-classic's DocRoot/Layout component.
+ *
+ * The original only renders the sidebar + main content area.
+ * This override injects a custom SecondaryNavbar above that content, which adds:
+ *   - A breadcrumb trail (Home > Section > [current page path])
+ *   - A version dropdown (when multiple doc versions exist)
+ *
+ * Docusaurus picks this file automatically because it lives at
+ * src/theme/DocRoot/Layout/index.tsx, shadowing the original in node_modules.
+ */
+
 import {
 	useActiveDocContext,
 	useActivePlugin,