Update protocol doc generation to .mdx

Has inline JSX, and the next major version of Docusaurus will render
.md and .mdx files differently.

.gitattributes

@@ -7,7 +7,7 @@
 /database/mock/*.go linguist-generated=true
 /docs/docs/ref/cli/*.md linguist-generated=true
 /docs/docs/ref/schema.md linguist-generated=true
-/docs/docs/ref/proto.md linguist-generated=true
+/docs/docs/ref/proto.mdx linguist-generated=true
 /pkg/api/openapi/** linguist-generated=true
 /pkg/api/protobuf/go/minder/v1/*.pb.go linguist-generated=true
 /pkg/api/protobuf/go/minder/v1/*.gw.go linguist-generated=true

buf.gen.yaml

@@ -26,4 +26,4 @@ plugins:
     # https://github.com/pseudomuto/protoc-gen-doc/issues/513
     # buf.build/community/pseudomuto-doc:v1.5.1
     out: docs/docs/ref
-    opt: "docs/proto_template.tmpl,proto.md:internal.proto"
+    opt: "docs/proto_template.tmpl,proto.mdx:internal.proto"

docs/.markdownlint-cli2.jsonc

@@ -1,11 +1,5 @@
 {
   "gitignore": true,
   "globs": ["**/*.md"],
-  "ignores": [
-    "node_modules/",
-    ".docusaurus",
-    "build/",
-    "docs/ref/cli/",
-    "docs/ref/proto.md",
-  ],
+  "ignores": ["node_modules/", ".docusaurus", "build/", "docs/ref/cli/"],
 }

docs/.prettierignore

@@ -4,4 +4,4 @@ build/
 
 # Auto-generated files
 docs/ref/cli/*.md
-docs/ref/proto.md
+docs/ref/proto.mdx

docs/eslint.config.mjs

@@ -11,13 +11,7 @@ import * as mdx from 'eslint-plugin-mdx';
 /** @type {import('eslint').Linter.Config[]} */
 export default [
   {
-    ignores: [
-      '.docusaurus/',
-      'build/',
-      'import/',
-      'docs/minder/',
-      'node_modules/',
-    ],
+    ignores: ['.docusaurus/', 'build/', 'node_modules/', 'docs/ref/proto.mdx'],
   },
   { files: ['**/*.{js,mjs,cjs,ts,jsx,tsx}'] },
   { languageOptions: { globals: globals.node } },

docs/proto_template.tmpl

@@ -1,6 +1,6 @@
 ---
-sidebar_position: 60
 title: Protocol documentation
+sidebar_position: 60
 toc_max_heading_level: 4
 ---