fix(build): make docs build work with Docusaurus 3.10 (#77)

Docusaurus 3.10 requires `@docusaurus/faster` to be declared as an
explicit dependency whenever `future.v4` is enabled, and it also flips
`mdx1CompatDisabledByDefault` to `true`, which dropped support for HTML
comments in `.md` files.

Add `@docusaurus/faster` to the dependencies, and move the `markdown`
config to the top level of `Config` with the real `mdx1Compat` keys
(`comments`, `admonitions`, `headingIds`). The previous block was nested
inside `themeConfig` and used non-existent keys, so it had always been a
no-op; it only happened to work on 3.9 because the defaults matched.

Closes #76

Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>

Author: mnencia

website/docusaurus.config.ts

@@ -182,21 +182,22 @@ const config: Config = {
       <a href="https://www.postgresql.org/about/policies/trademarks">Postgres, PostgreSQL and the Slonik Logo are
         trademarks or registered trademarks of the PostgreSQL Community Association of Canada, and
         used with their permission</a>.`
-    },
-      markdown: {
-          mdx1Compat: {
-            allowComments: true,
-            allowHtml: true,
-      },
-      hooks: {
-        onBrokenMarkdownLinks: 'throw',
-      },
     },
     prism: {
       theme: prismThemes.github,
       darkTheme: prismThemes.dracula,
     },
   } satisfies Preset.ThemeConfig,
+  markdown: {
+    mdx1Compat: {
+      comments: true,
+      admonitions: true,
+      headingIds: true,
+    },
+    hooks: {
+      onBrokenMarkdownLinks: 'throw',
+    },
+  },
   plugins: [
       [
           '@docusaurus/plugin-client-redirects',

website/package.json

@@ -16,6 +16,7 @@
   },
   "dependencies": {
     "@docusaurus/core": "3.10.0",
+    "@docusaurus/faster": "3.10.0",
     "@docusaurus/plugin-client-redirects": "3.10.0",
     "@docusaurus/preset-classic": "3.10.0",
     "@easyops-cn/docusaurus-search-local": "^0.55.0",