chore: update docusaurus config (#362)

* chore: update docusaurus config

* fix: updated

* chore: replaced @ts-ignore with @ts-expect-error

* chore: added comments

Author: Tony133

docusaurus.config.js

@@ -21,7 +21,6 @@ const config = {
   url: 'https://fastify.io',
   baseUrl: BASE_URL,
   onBrokenLinks: 'warn',
-  onBrokenMarkdownLinks: 'warn',
   favicon: 'img/favicon.ico',
   // GitHub Pages redirects with a trailing slash, so this configures links to match
   trailingSlash: true,
@@ -35,6 +34,12 @@ const config = {
     locales: ['en'],
   },
 
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn',
+    },
+  },
+
   // https://docusaurus.io/docs/using-plugins#using-presets
   presets: [
     [
@@ -215,6 +220,7 @@ const config = {
             to: '/organizations',
           },
         ],
+        // @ts-expect-error provided types doesn't match the real possible configuration
         createRedirects(existingPath) {
           // Legacy/Retro compatibility:
 
@@ -225,6 +231,7 @@ const config = {
 
           // Redirect for old /docs/v3.<x>.<y>/ URLs to the latest v3 version
           if (existingPath.startsWith('/docs/v3')) {
+            // @ts-expect-error provided types doesn't match the real possible configuration
             return u.manageRedirects({
               existingPath,
               major: '3',
@@ -236,6 +243,7 @@ const config = {
 
           // Redirect for old /docs/v2.<x>.<y>/ URLs to the latest v2 version
           if (existingPath.startsWith('/docs/v2')) {
+            // @ts-expect-error provided types doesn't match the real possible configuration
             return u.manageRedirects({
               existingPath,
               major: '2',