Merge branch 'main' into expand-calm-example-write-up

Author: jimthompson5802

docs/docusaurus.config.js

@@ -24,7 +24,6 @@ const config = {
     projectName: 'architecture-as-code', // Usually your repo name.
 
     onBrokenLinks: 'throw',
-    onBrokenMarkdownLinks: 'warn',
 
     // 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
@@ -34,6 +33,12 @@ const config = {
         locales: ['en'],
     },
 
+    markdown: {
+        hooks: {
+            onBrokenMarkdownLinks: 'warn'
+        }
+    },
+
     presets: [
         [
             'classic',