diff --git a/docs/concepts/ai.md b/docs/concepts/ai.md
index 06b7b335e..28821788f 100644
--- a/docs/concepts/ai.md
+++ b/docs/concepts/ai.md
@@ -7,7 +7,7 @@ sidebar_position: 100
 # AI
 
 
-Defang includes an AI-driven assistant that translates natural language prompts to an outline for your project that you can then refine. The AI assistant is available through the [Defang CLI](./getting-started/installing.md).
+Defang includes an AI-driven assistant that translates natural language prompts to an outline for your project that you can then refine. The AI assistant is available through the [Defang CLI](../getting-started/installing.md).
 
 :::info
 The AI assistant is currently in beta and only supports a limited set of prompts. We plan to expand the capabilities of the AI assistant in the future.
diff --git a/docs/intro.md b/docs/intro.md
index 6acb896f8..3b52bc653 100644
--- a/docs/intro.md
+++ b/docs/intro.md
@@ -26,7 +26,7 @@ Defang provides a streamlined experience to develop, deploy, observe, and update
 - Support for [pre-built Docker containers](./tutorials/deploy-container-using-the-cli.mdx), from public or private image registries
 - Ability to express your project configuration using a [Docker Compose YAML](./concepts/compose.md) file
 - Ability to manage encrypted [secrets](./concepts/secrets.md) and [configuration](./concepts/configuration.md)
-- Pre-configured environments with built-in [security](./concepts/security.md), [networking](./concepts/networking.md), and [observability](./concepts/observability.md)
+- Pre-configured environments with built-in [security](./concepts/security.md), [networking](./concepts/networking.mdx), and [observability](./concepts/observability.md)
 - [One-command deployments](./getting-started/installing.md)
 - Support for [GPUs](./concepts/resources.md)
 - Support for Infra-as-Code via the [Defang Pulumi provider](./concepts/pulumi.md)
diff --git a/docusaurus.config.js b/docusaurus.config.js
index c0decd0f3..38757ff5f 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -27,8 +27,8 @@ const config = {
   projectName: 'defang-docs', // Usually your repo name.
   trailingSlash: false,
 
-  onBrokenLinks: 'ignore',
-  onBrokenMarkdownLinks: 'warn',
+  onBrokenLinks: 'warn',
+  onBrokenMarkdownLinks: 'throw',
 
   // Even if you don't use internalization, you can use this field to set useful
   // metadata like html lang. For example, if your site is Chinese, you may want