feat(website): update documentation structure for alternative parser guides

Author: Rel1cx

website/app/overrides.css

@@ -1,3 +1,8 @@
+#nd-docs-layout #nd-sidebar a {
+  margin-top: 0.375rem;
+  margin-bottom: 0.375rem;
+}
+
 #nd-docs-layout #nd-sidebar a[data-active] {
   font-weight: 400;
 }

website/content/docs/configurations.mdx

@@ -2,13 +2,26 @@
 title: Configurations
 ---
 
-import { ConfigurationsTypeTable } from "./configurations"
+import { SettingsTypeTable } from "./configurations";
 
-ESLint React provides the following configurations:
+A [configuration object](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects) is used to configure the behavior of the rules in ESLint React. You can define the settings object in the `settings["react-x"]` field of your ESLint configuration file.
+
+```ts title="eslint.config.js"
+export default [
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    settings: {
+      "react-x": {
+        version: "19.0.0",
+      },
+    },
+  },
+];
+```
 
 ## Properties
 
-<ConfigurationsTypeTable />
+<SettingsTypeTable />
 
 ## Descriptions
 

website/content/docs/configurations.tsx

@@ -4,7 +4,7 @@ import { DynamicCodeBlock } from "fumadocs-ui/components/dynamic-codeblock";
 import { TypeTable } from "fumadocs-ui/components/type-table";
 import { Link } from "next-view-transitions";
 
-export function ConfigurationsTypeTable() {
+export function SettingsTypeTable() {
   return (
     <TypeTable
       type={{

website/content/docs/getting-started/meta.json

@@ -2,9 +2,7 @@
   "title": "Getting Started",
   "pages": [
     "javascript",
-    "javascript-with-alternative-parser",
-    "typescript",
-    "typescript-with-alternative-parser"
+    "typescript"
   ],
   "defaultOpen": true
 }

website/content/docs/meta.json

@@ -6,6 +6,7 @@
     "rules",
     "presets",
     "configurations",
+    "using-an-alternative-parser",
     "!advanced-configuration",
     "---Other---",
     "faq",

website/content/docs/getting-started/javascript-with-alternative-parser.mdx renamed to website/content/docs/using-an-alternative-parser/babel-eslint-parser.mdx

@@ -1,6 +1,6 @@
 ---
-title: JavaScript with alternative parser
-description: Getting started with JavaScript + Babel ESLint Parser setup
+title: "@babel/eslint-parser"
+description: "Using @babel/eslint-parser as an alternative parser for JavaScript projects"
 ---
 
 ## Install

website/content/docs/using-an-alternative-parser/meta.json

@@ -0,0 +1,7 @@
+{
+  "title": "Using an alternative parser",
+  "pages": [
+    "babel-eslint-parser",
+    "ts-blank-eslint-parser"
+  ]
+}

website/content/docs/getting-started/typescript-with-alternative-parser.mdx renamed to website/content/docs/using-an-alternative-parser/ts-blank-eslint-parser.mdx

@@ -1,6 +1,6 @@
 ---
-title: TypeScript with alternative parser
-description: Getting started with TypeScript + TS Blank ESLint Parser setup
+title: "ts-blank-eslint-parser"
+description: "Using ts-blank-eslint-parser as an alternative parser for TypeScript projects"
 ---
 
 <Callout type="warn">

website/next.config.mjs

@@ -22,6 +22,16 @@ const config = {
         destination: "/docs/getting-started/javascript",
         permanent: true,
       },
+      {
+        source: "/docs/getting-started/javascript-with-alternative-parser",
+        destination: "/docs/using-an-alternative-parser/babel-eslint-parser",
+        permanent: true,
+      },
+      {
+        source: "/docs/getting-started/typescript-with-alternative-parser",
+        destination: "/docs/using-an-alternative-parser/ts-blank-eslint-parser",
+        permanent: true,
+      },
       {
         source: "/docs/rules",
         destination: "/docs/rules/overview",