fix(docs): repair dead links and fail the build on broken links (#1154)

* fix(docs): repair dead internal links and image paths

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

* build(docs): fail the build on broken links

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

Author: mazzma12

crowdsec-docs/docusaurus.config.ts

@@ -287,7 +287,7 @@ const config: Config = {
 	baseUrl: "/",
 	// Amplify serves `page/index.html` at `page/` and redirects `page` there, so canonical and sitemap URLs must end with a slash.
 	trailingSlash: true,
-	onBrokenLinks: "warn",
+	onBrokenLinks: "throw",
 	onBrokenMarkdownLinks: "warn",
 	favicon: "img/crowdsec_no_txt.png",
 	organizationName: "CrowdSec",

crowdsec-docs/src/sectionMap.ts

@@ -34,7 +34,7 @@ export const SECTION_MAP: Record<string, SectionInfo> = {
 	},
 	cscliSidebar: {
 		label: "Cscli",
-		introPath: "/docs/cscli/cscli",
+		introPath: "/docs/next/cscli",
 		parent: { label: "Security Engine", introPath: "/docs/intro" },
 	},
 	sdkSideBar: {

crowdsec-docs/unversioned/blocklists/security_engine.mdx

@@ -27,7 +27,7 @@ Install Remediation Component:
 - [Unix Firewall](bouncers/firewall.mdx)
 - [Nginx](bouncers/nginx.mdx)
 - [HAProxy](bouncers/haproxy.mdx)
-- [Cloudflare Workers](bouncers/cloudflare-workers.mdx)
+- [Cloudflare Workers](../bouncers/cloudflare.mdx)
 
 The above is just a limited selection of the available Remediation Components. To see the complete list, including Third Party options, visit the [Hub](https://hub.crowdsec.net/remediation-components).
 

crowdsec-docs/unversioned/bouncers/cloudflare-deprecated.mdx

@@ -9,7 +9,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 import BouncerHeader from "@site/src/components/bouncer-header";
 
 <p align="center">
-  <img src={useBaseUrl('/img/crowdsec_cloudfare.svg')} width="400" height="300" />
+  <img src={useBaseUrl('/img/crowdsec_cloudflare.svg')} width="400" height="300" />
 </p>
 
 <p align="center">
@@ -20,7 +20,7 @@ import BouncerHeader from "@site/src/components/bouncer-header";
 <BouncerHeader
   title="Cloudflare Bouncer (Deprecated)"
   typeLabel="DEPRECATED"
-  imgSrc="/img/crowdsec_cloudfare.svg"
+  imgSrc="/img/crowdsec_cloudflare.svg"
   description="Syncs CrowdSec decisions with Cloudflare Workers to block or challenge traffic on your zones."
   featuresSupport="streammode"
 />

crowdsec-docs/unversioned/bouncers/cloudflare.mdx

@@ -85,7 +85,7 @@ Here's a quick comparative overview:
 **Self-Hosted Installer** works best with a **Blocklist Integration Endpoint** — no infrastructure to expose, the Sync Worker pulls decisions directly from CrowdSec.
 
 Using a **self-hosted Security Engine (LAPI)** as the decision source requires the LAPI to be reachable from Cloudflare's network, which means exposing it publicly. If that's a concern:
-- **Premium users** can enable [Remediation Sync](/u/console/integrations/intro) on their Console integration — decisions are forwarded from the LAPI without exposing it to the internet.
+- **Premium users** can enable [Remediation Sync](/u/console/remediation_sync) on their Console integration — decisions are forwarded from the LAPI without exposing it to the internet.
 - Alternatively, use the **CLI Bouncer Daemon** running alongside your LAPI, so the bouncer pulls decisions locally and pushes them to Cloudflare without any inbound exposure.
 :::
 

crowdsec-docs/unversioned/bouncers/envoy.mdx

@@ -45,7 +45,7 @@ with WAF and virtual patching, follow the
 
 1. It is assumed that you already have:
    - A working CrowdSec
-     [Security Engine](/intro) installation. For a Kubernetes install
+     [Security Engine](/docs/next/intro) installation. For a Kubernetes install
      quickstart, refer to
      [/u/getting_started/installation/kubernetes](/u/getting_started/installation/kubernetes).
    - A working Envoy Gateway installation with the Gateway API CRDs and an

crowdsec-docs/unversioned/bouncers/traefik.mdx

@@ -60,7 +60,7 @@ At the end, you will have:
 
 It is assumed that you already have:
 
-- A working CrowdSec [Security Engine](/intro.mdx) installation. For a
+- A working CrowdSec [Security Engine](/docs/next/intro) installation. For a
   Kubernetes install quickstart, refer to
   [/u/getting_started/installation/kubernetes](/u/getting_started/installation/kubernetes).
 - A working Traefik installation in Kubernetes.

crowdsec-docs/unversioned/console/premium_upgrade.mdx

@@ -188,7 +188,6 @@ export const personaOptions = [
 		before: "Community: 1 user only",
 		after: "Premium: full team"
 	}}
-	link="/u/console/organizations/intro"
 />
 
 <FeatureCard
@@ -316,7 +315,7 @@ export const personaOptions = [
 	metric="15k → 60k IPs"
 	category="protection"
 	description="Top 60k most aggressive attackers (up from 3,000 in Community)."
-	link="/u/console/blocklists/intro"
+	link="/u/console/blocklists/overview"
 />
 
 <FeatureCard
@@ -427,7 +426,6 @@ export const personaOptions = [
 	metric="3 seats included"
 	category="scale"
 	description="Provide view/edit/admin access to team members or clients. Add seats as your business grows."
-	link="/u/console/organizations/intro"
 />
 
 <FeatureCard
@@ -451,7 +449,7 @@ export const personaOptions = [
 	metric="15k → 60k IPs"
 	category="protection"
 	description="Access to 60k most aggressive IPs (vs 15k in Community)."
-	link="/u/console/blocklists/intro"
+	link="/u/console/blocklists/overview"
 />
 
 <FeatureCard

crowdsec-docs/unversioned/console/premium_upgrade/features_overview.mdx

@@ -91,7 +91,6 @@ Make the best use of the premium features for your needs in: **Scaling, Multi-te
 		before: "Community: 1 user only",
 		after: "Premium: full team (5+)"
 	}}
-	link="/u/console/organizations/intro"
 />
 
 </DocCardGrid>

crowdsec-docs/unversioned/console/premium_upgrade/optimal_setup.mdx

@@ -70,8 +70,6 @@ Create a new organization specifically for your Production environment.
 
 **Community accounts** get **1 extra organization for free** (beyond your Personal Account).
 
-[Learn about Organizations →](/u/console/organizations/intro)
-
 </div>
 
 <div className="border border-solid border-border rounded-lg p-6 bg-card text-left">