diff --git a/docs/contribution/4-solve-tickets.mdx b/docs/contribution/4-solve-tickets.mdx
index 2549555..65d184f 100644
--- a/docs/contribution/4-solve-tickets.mdx
+++ b/docs/contribution/4-solve-tickets.mdx
@@ -141,6 +141,6 @@ If you want to **directly contribute a fix for a bug**, please follow the steps
     - Description of the fix and the use cases / solved requirements
     - Suitable reviewers for your change (feel free to reach out to us if you need help)
     - A reference to the original bug issue
-6. Check that your contribution meets the [**Definition of Done**](/docs/code-release-publish#definition-of-done) and that all tests are **passing**
-7. Create a release candidate (see our guide here: [Release process](/docs/code-release-publish#build-release-candidate))
+6. Check that your contribution meets the [**Definition of Done**](/docs/contribution/code-release-publish#definition-of-done) and that all tests are **passing**
+7. [Create a release candidate](/docs/contribution/code-release-publish#build-release-candidate)
 8. Get in contact with the issue reporter to validate your fix 💬
\ No newline at end of file
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 54d9702..fc4d96a 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -18,8 +18,15 @@ const config = {
   organizationName: 'SAP',
   projectName: 'crossplane-provider-docs',
 
-  onBrokenLinks: 'warn',
-  onBrokenMarkdownLinks: 'warn',
+  onBrokenLinks: 'throw',
+  onBrokenAnchors: 'throw',
+  onDuplicateRoutes: 'throw',
+
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'throw',
+    },
+  },
 
   i18n: {
     defaultLocale: 'en',
@@ -90,11 +97,11 @@ const config = {
               },
               {
                 label: 'crossplane-provider-btp',
-                to: '/docs/crossplane-provider-btp/docs/end-user-guides/import-landscape/external-name',
+                to: '/docs/crossplane-provider-btp/docs/end-user-guides/btp',
               },
               {
                 label: 'crossplane-provider-hana',
-                to: '/docs/crossplane-provider-hana/docs/contribution-notes/20250822-hana-x509-authentication',
+                to: '/docs/crossplane-provider-hana/docs/end-user-guides/hana',
               },
             ],
           },
diff --git a/src/pages/index.js b/src/pages/index.js
index 1b4ffa3..201de0e 100644
--- a/src/pages/index.js
+++ b/src/pages/index.js
@@ -49,7 +49,7 @@ export default function Home() {
                   <a href="/crossplane-provider-docs/docs/crossplane-provider-btp/docs/end-user-guides/btp">crossplane-provider-btp</a>
                 </div>
                 <div className="action medium alt">
-                  <a href="/crossplane-provider-docs/docs/crossplane-provider-hana/docs/end-user-guides/setup">crossplane-provider-hana</a>
+                  <a href="/crossplane-provider-docs/docs/crossplane-provider-hana/docs/end-user-guides/hana">crossplane-provider-hana</a>
                 </div>
               </div>
             </div>