diff --git a/docs/docs/misc/contributing/getting-started.mdx b/docs/docs/misc/contributing/getting-started.mdx
index 2c6310d2ae..5f5cea0dc2 100644
--- a/docs/docs/misc/contributing/getting-started.mdx
+++ b/docs/docs/misc/contributing/getting-started.mdx
@@ -9,7 +9,7 @@ Thanks for your interest in contributing to Agenta! We appreciate your effort an
 
 1. **Local Installation:** First, set up the project on your local machine. Follow the steps in our [Local Installation Guide](/self-host/host-locally).
 
-2. **Understand the Project:** Familiarize yourself with our architecture and concepts by reading our [Guide](/guides/how_does_agenta_work).
+2. **Understand the Project:** Familiarize yourself with our architecture and concepts by reading our [Guide](/concepts/architecture).
 
 3. **Begin Development:** Once you've installed the project and understand its architecture, you're ready to contribute. See the [Development Mode Tutorial](/misc/contributing/development-mode) for instructions on running the code in development mode.
 
diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts
index 416d3712a6..2a0a1d5fce 100644
--- a/docs/docusaurus.config.ts
+++ b/docs/docusaurus.config.ts
@@ -17,8 +17,9 @@ const config: Config = {
   baseUrl: "/",
   organizationName: "Agenta-AI",
   projectName: "agenta",
-  onBrokenLinks: "ignore",
-  onBrokenMarkdownLinks: "warn",
+  onBrokenLinks: "throw",
+  onBrokenMarkdownLinks: "throw",
+  onBrokenAnchors: "throw",
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you