more cleanup

Author: acolytec3

docs/intro.md docs/reference/intro.mddocs/intro.md renamed to docs/reference/intro.md

@@ -115,4 +115,4 @@ others don't.
 
 [exec-apis]: https://github.com/ethereum/execution-apis
 [pm]: https://github.com/ethereum/pm
-[test-gen]: ../tests/README.md
+[test-gen]: ./tests/README.md

docs/making-changes.md docs/reference/making-changes.mddocs/making-changes.md renamed to docs/reference/making-changes.md

@@ -5,23 +5,23 @@ import type * as Preset from '@metamask/docusaurus-openrpc/dist/preset';
 // This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)
 
 const config: Config = {
-  title: 'My Site',
-  tagline: 'Dinosaurs are cool',
+  title: 'Ethereum Execution APIs',
+  tagline: 'A JSON-RPC specification for Ethereum execution clients',
   favicon: 'img/favicon.ico',
 
   // Set the production url of your site here
   url: 'https://acolytec3.github.io',
   // Set the /<baseUrl>/ pathname under which your site is served
   // For GitHub pages deployment, it is often '/<projectName>/'
-  baseUrl: '/execution-apis/',
+  baseUrl: '/',
 
   // GitHub pages deployment config.
   // If you aren't using GitHub pages, you don't need these.
   organizationName: 'acolytec3', // Usually your GitHub org/user name.
   projectName: 'execution-apis', // Usually your repo name.
   deploymentBranch: 'gh-pages',
 
-  onBrokenLinks: 'warn',
+  onBrokenLinks: 'throw',
   onBrokenMarkdownLinks: 'warn',
 
   // Even if you don't use internationalization, you can use this field to set
@@ -41,12 +41,11 @@ const config: Config = {
           routeBasePath: '/',
           openrpc: {
             openrpcDocument: './refs-openrpc.json',
-            path: 'Reference',
+            path: 'reference',
             sidebarLabel: 'JSON-RPC',
           },
           sidebarPath: './sidebars.ts',
           path: './docs',
-          id: 'reference',
         },
         blog: false,
         theme: {
@@ -61,10 +60,10 @@ const config: Config = {
     image: 'img/docusaurus-social-card.jpg',
     navbar: {
       title: 'Execution APIs',
-      logo: {
-        alt: 'My Site Logo',
-        src: 'img/logo.svg',
-      },
+      // logo: {
+      //   alt: 'My Site Logo',
+      //   src: 'img/logo.svg',
+      // },
       items: [
         {
           type: 'docSidebar',

docusaurus.config.ts

@@ -3,7 +3,6 @@
   "version": "0.0.0",
   "description": "Collection of JSON-RPC APIs provided by Ethereum 1.0 clients",
   "main": "index.js",
-  "type": "module",
   "scripts": {
     "build": "npm run build:spec",
     "build:spec": "node scripts/build.js",
@@ -34,6 +33,9 @@
   },
   "homepage": "https://github.com/ethereum/execution-apis#readme",
   "devDependencies": {
+    "@docusaurus/module-type-aliases": "3.7.0",
+    "@docusaurus/tsconfig": "3.7.0",
+    "@docusaurus/types": "3.7.0",
     "@graphql-inspector/core": "~3.3.0",
     "@open-rpc/generator": "1.18.6",
     "@open-rpc/schema-utils-js": "1.15.0",
@@ -43,18 +45,16 @@
     "graphql-request": "~4.1.0",
     "js-yaml": "~4.1.0",
     "json-schema-merge-allof": "~0.8.1",
-    "@docusaurus/module-type-aliases": "3.7.0",
-    "@docusaurus/tsconfig": "3.7.0",
-    "@docusaurus/types": "3.7.0",
     "typescript": "~5.6.2"
   },
   "dependencies": {
     "@docusaurus/core": "3.7.0",
+    "@docusaurus/plugin-content-docs": "^3.7.0",
     "@mdx-js/react": "^3.0.0",
     "@metamask/docusaurus-openrpc": "^0.4.1",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
   }
-}
+}

package-lock.json

@@ -20,7 +20,7 @@ const sidebars: SidebarsConfig = {
     items: [
       {
         type: "autogenerated",
-        dirName: ".",
+        dirName: "reference",
       }
     ],
   },],