Merge pull request #1054 from crowdsecurity/LET_revamp

LET : doc v2

Author: buixor

README.md

@@ -8,23 +8,29 @@ The documentation is built using [Docusaurus](https://docusaurus.io/), a modern
 
 ## Pre-requisites
 
-- Node.js (version 20 or later)
-- npm (Node package manager)
+- [nvm](https://github.com/nvm-sh/nvm) (Node Version Manager)
+- Node.js stable (install via nvm: `nvm install stable && nvm use stable`)
 - VSCode with recommended extensions installed (see `.vscode/extensions.json`)
 
 ## Installation
 
 ```console
+nvm use stable
+cd crowdsec-docs
 npm install
 ```
 
 ## Local Development
 
 ```console
-npm run start
+nvm use stable
+cd crowdsec-docs
+npm start
+# or equivalently
+npx docusaurus start
 ```
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+This command starts a local development server at http://localhost:3000. Most changes are reflected live without having to restart the server.
 
 ## Build
 

crowdsec-docs/docusaurus.config.ts

@@ -227,6 +227,7 @@ const config: Config = {
 	organizationName: "CrowdSec",
 	projectName: "crowdsec-docs",
 	markdown: {
+		mermaid: true,
 		mdx1Compat: {
 			comments: true,
 			admonitions: true,
@@ -239,6 +240,7 @@ const config: Config = {
 			href: "https://fonts.googleapis.com/icon?family=Material+Icons",
 		},
 	],
+	themes: ["@docusaurus/theme-mermaid"],
 	themeConfig: {
 		image: "img/crowdsec_og_image.png",
 		colorMode: {

crowdsec-docs/package-lock.json

@@ -24,6 +24,7 @@
         "@docusaurus/plugin-client-redirects": "^3.9.2",
         "@docusaurus/preset-classic": "^3.9.2",
         "@docusaurus/theme-common": "^3.9.2",
+        "@docusaurus/theme-mermaid": "^3.9.2",
         "@docusaurus/theme-search-algolia": "^3.9.2",
         "@emotion/react": "^11.14.0",
         "@emotion/styled": "^11.14.0",

crowdsec-docs/package.json

@@ -91,28 +91,101 @@ const sidebarsUnversionedConfig: SidebarConfig = {
 	trackerApiSidebar: [
 		{
 			type: "doc",
-			label: "Getting Started",
+			label: "Overview",
 			id: "tracker_api/intro",
 		},
 		{
-			type: "doc",
-			label: "Prioritize",
-			id: "tracker_api/prioritize",
+			type: "category",
+			label: "Understanding the Data",
+			items: [
+				{
+					type: "doc",
+					label: "Scores & Ratings",
+					id: "tracker_api/scores",
+				},
+				{
+					type: "doc",
+					label: "Exploitation Phases",
+					id: "tracker_api/exploitation_phases",
+				},
+				{
+					type: "doc",
+					label: "CrowdSec Analysis",
+					id: "tracker_api/crowdsec_analysis",
+				},
+				{
+					type: "doc",
+					label: "Threat Context",
+					id: "tracker_api/threat_context",
+				},
+				{
+					type: "doc",
+					label: "Reconnaissance Rules vs CVEs",
+					id: "tracker_api/fingerprints_vs_cves",
+				},
+			],
 		},
 		{
 			type: "doc",
-			label: "Mitigate",
-			id: "tracker_api/mitigate",
+			label: "Web Interface",
+			id: "tracker_api/web_interface",
 		},
 		{
-			type: "doc",
-			label: "API Reference",
-			id: "tracker_api/api_reference",
+			type: "category",
+			label: "API",
+			items: [
+				{
+					type: "doc",
+					label: "Authentication & Setup",
+					id: "tracker_api/api_authentication",
+				},
+				{
+					type: "doc",
+					label: "CVEs",
+					id: "tracker_api/api_cves",
+				},
+				{
+					type: "doc",
+					label: "Reconnaissance / Fingerprints",
+					id: "tracker_api/api_fingerprints",
+				},
+				{
+					type: "doc",
+					label: "Vendors, Products & Tags",
+					id: "tracker_api/api_lookups",
+				},
+				{
+					type: "doc",
+					label: "Integrations & Blocklists",
+					id: "tracker_api/api_integrations",
+				},
+				{
+					type: "doc",
+					label: "SDKs & Libraries",
+					id: "tracker_api/api_sdks",
+				},
+				{
+					type: "doc",
+					label: "API Reference",
+					id: "tracker_api/api_reference",
+				},
+			],
 		},
 		{
-			type: "doc",
-			label: "Web Interface",
-			id: "tracker_api/web_interface",
+			type: "category",
+			label: "Guides",
+			items: [
+				{
+					type: "doc",
+					label: "Triage Workflow",
+					id: "tracker_api/guide_triage",
+				},
+				{
+					type: "doc",
+					label: "Proactive Monitoring",
+					id: "tracker_api/guide_proactive",
+				},
+			],
 		},
 	],
 	consoleSidebar: [