ardatan
diff --git a/‎.gitignore‎
Lines changed: 2 additions & 0 deletions b/‎.gitignore‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 0 deletions b/‎package.json‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎scripts/build-api-docs.js‎
Lines changed: 31 additions & 17 deletions b/‎scripts/build-api-docs.js‎
Lines changed: 31 additions & 17 deletions
diff --git a/‎scripts/typedoc-theme/theme.js‎
Lines changed: 3 additions & 2 deletions b/‎scripts/typedoc-theme/theme.js‎
Lines changed: 3 additions & 2 deletions
diff --git a/‎website/.gitignore‎
Lines changed: 0 additions & 26 deletions b/‎website/.gitignore‎
Lines changed: 0 additions & 26 deletions
diff --git a/‎website/README.md‎
Lines changed: 0 additions & 42 deletions b/‎website/README.md‎
Lines changed: 0 additions & 42 deletions
diff --git a/‎website/docs/connectors.md‎ renamed to ‎website/docs/guides/connectors.mdx‎ b/‎website/docs/connectors.md‎ renamed to ‎website/docs/guides/connectors.mdx‎
diff --git a/‎website/docs/documents-loading.md‎ renamed to ‎website/docs/guides/documents-loading.mdx‎ b/‎website/docs/documents-loading.md‎ renamed to ‎website/docs/guides/documents-loading.mdx‎
diff --git a/‎website/docs/generate-schema.md‎ renamed to ‎website/docs/guides/generate-schema.mdx‎
Lines changed: 21 additions & 15 deletions b/‎website/docs/generate-schema.md‎ renamed to ‎website/docs/guides/generate-schema.mdx‎
Lines changed: 21 additions & 15 deletions
diff --git a/‎website/docs/graphql-tag-pluck.md‎ renamed to ‎website/docs/guides/graphql-tag-pluck.mdx‎ b/‎website/docs/graphql-tag-pluck.md‎ renamed to ‎website/docs/guides/graphql-tag-pluck.mdx‎
@@ -77,3 +77,5 @@ junit.xml
 
 package-lock.json
 website/yarn.lock
+website/api-sidebar.json
+website/docs/api
@@ -97,6 +97,7 @@
   },
   "resolutions": {
     "graphql": "15.5.1",
+    "esbuild": "^0.12.8",
     "@changesets/apply-release-plan": "5.0.0"
   }
 }
@@ -34,6 +34,7 @@ async function buildApiDocs() {
     const packageJsonContent = require(path.join(__dirname, '..', packageJsonPath));
     // Do not include private and large npm package that contains rest
     if (
+      !packageJsonPath.includes('./website/') &&
       !packageJsonContent.private &&
       packageJsonContent.name !== MONOREPO &&
       !packageJsonContent.name.endsWith('/container')
@@ -80,6 +81,13 @@ async function buildApiDocs() {
       // Escape angle brackets
       .replace(/</g, '&lt;')
       .replace(/>/g, '&gt;')
+      // Fix title
+      .replace(/^# .+/g, function (match) {
+        return `---
+title: '${match.replace('# ', '')}'
+---
+${match}`;
+      })
       // Fix links
       .replace(/\[([^\]]+)\]\(([^)]+).md\)/g, '[$1]($2)')
       .replace(/\[([^\]]+)\]\((\.\.\/(classes|interfaces|enums)\/([^\)]+))\)/g, '[$1](/docs/api/$3/$4)');
@@ -109,8 +117,8 @@ async function buildApiDocs() {
     })
   );
 
-  // Remove the generated "index.md" file
-  // fs.unlinkSync(path.join(outputDir, 'index.md'));
+  // Remove the generated "README.md" file
+  fs.unlinkSync(path.join(outputDir, 'README.md'));
 
   // Update each module 's frontmatter and title
   await Promise.all(
@@ -142,20 +150,27 @@ sidebar_label: "${id}"
   fs.writeFileSync(
     sidebarsPath,
     JSON.stringify(
-      [
-        {
-          Modules: modules.map(([name]) => `api/modules/${convertNameToId(name)}`),
-        },
-        {
-          Classes: getSidebarItemsByDirectory(path.join(outputDir, 'classes')),
-        },
-        {
-          Interfaces: getSidebarItemsByDirectory(path.join(outputDir, 'interfaces')),
-        },
-        {
-          Enums: getSidebarItemsByDirectory(path.join(outputDir, 'enums')),
+      {
+        $name: 'API Reference',
+        _: {
+          modules: {
+            $name: 'Modules',
+            $routes: getSidebarItemsByDirectory(path.join(outputDir, 'modules')),
+          },
+          classes: {
+            $name: 'Classes',
+            $routes: getSidebarItemsByDirectory(path.join(outputDir, 'classes')),
+          },
+          interfaces: {
+            $name: 'Interfaces',
+            $routes: getSidebarItemsByDirectory(path.join(outputDir, 'interfaces')),
+          },
+          enums: {
+            $name: 'Enums',
+            $routes: getSidebarItemsByDirectory(path.join(outputDir, 'enums')),
+          },
         },
-      ],
+      },
       null,
       2
     )
@@ -183,8 +198,7 @@ sidebar_label: "${id}"
         const absoluteFilePath = path.join(dirName, fileName);
         const fileLstat = fs.lstatSync(absoluteFilePath);
         if (fileLstat.isFile()) {
-          const relativeDirName = path.relative(outputDir, dirName);
-          return `api/${relativeDirName}/${path.parse(fileName).name}`;
+          return path.parse(fileName).name;
         } else {
           return getSidebarItemsByDirectory(absoluteFilePath);
         }
 
@@ -1,7 +1,8 @@
-const MarkdownTheme = require('typedoc-plugin-markdown/dist/theme');
+const { default: MarkdownTheme } = require('typedoc-plugin-markdown/dist/theme');
+
 const { PageEvent } = require('typedoc/dist/lib/output/events');
 
-exports.default = class DocusaurusTheme extends MarkdownTheme {
+module.exports = class DocusaurusTheme extends MarkdownTheme {
   /**
    * Escape characters for mdx support after render
    */
 
@@ -105,10 +105,11 @@ This example has the entire type definition in one string and all resolvers in o
 
 ## Extending Types
 
-It's easy to add additional fields to existing types using the `extend` keyword.  Using `extend` is particularly useful in avoiding a large list of fields on root Queries and Mutations.  You can use it like this:
+It's easy to add additional fields to existing types using the `extend` keyword. Using `extend` is particularly useful in avoiding a large list of fields on root Queries and Mutations. You can use it like this:
 
 ```js
-const typeDefs = [`
+const typeDefs = [
+  `
   schema {
     query: Query
   }
@@ -120,15 +121,17 @@ const typeDefs = [`
   type Bar {
     id
   }
-  `, `
+  `,
+  `
   type Foo {
     id: String!
   }
 
   extend type Query {
     foos: [Foo]!
   }
-`]
+`,
+];
 ```
 
 If one of the types extended needs a resolver you can use `makeExecutableSchema` like this:
@@ -138,39 +141,42 @@ const barsResolver = {
   Query: {
     bars(parent, args, context, info) {
       // ...
-    }
-  }
+    },
+  },
 };
 
 const foosResolver = {
   Query: {
     foos(parent, args, context, info) {
       // ...
-    }
-  }
-}
+    },
+  },
+};
 
 const schema = makeExecutableSchema({
   typeDefs,
-  resolvers: [barsResolver, foosResolver]
-})
+  resolvers: [barsResolver, foosResolver],
+});
 ```
 
 ## Learning the GraphQL schema language
 
 The official documentation on graphql.org now has [a section about GraphQL schemas](http://graphql.org/learn/schema/) which explains all of the different schema features and how to use them with the schema language.
 
 The type definitions must define a query type, which means a minimal schema would look something like this:
+
 ```js
-const typeDefs = [`
+const typeDefs = [
+  `
   schema {
     query: RootQuery
   }
 
   type RootQuery {
     aNumber: Int
   }
-`];
+`,
+];
 ```
 
 ## Descriptions & Deprecations
@@ -232,16 +238,16 @@ const jsSchema = makeExecutableSchema({
 - `parseOptions` is an optional argument which allows customization of parse when specifying `typeDefs` as a string.
 
 - `resolverValidationOptions` is an optional argument with the following properties, each of which can be set to `error`, `warn`, or `ignore`:
+
   - `requireResolversForArgs` will cause `makeExecutableSchema` to throw an error (`error`) or issue a warning (`warn`)unless a resolver is defined for every field with arguments. The default is `ignore`, causing this validator to be skipped.
 
   - `requireResolversForNonScalar` require a resolver for every non-scalar field. Default is `ignore`.
 
-  - `requireResolversForAllFields` asserts that *all* fields have valid resolvers. This option cannot be set in combination with the previous two validators. Default is `ignore`.
+  - `requireResolversForAllFields` asserts that _all_ fields have valid resolvers. This option cannot be set in combination with the previous two validators. Default is `ignore`.
 
   - `requireResolversForResolveType` will require a `resolveType()` method for Interface and Union types. This can be passed in with the field resolvers as `__resolveType()`. Default is `ignore`.
 
   - `requireResolversToMatchSchema` requires every resolver within the resolver map to correspond to a GraphQL entity within the schema. Defaults to `error`, to help catch common errors.
 
 - `inheritResolversFromInterfaces` GraphQL Objects that implement interfaces will inherit missing resolvers from their interface types defined in the `resolvers` object.
 
-
Original file line number	Diff line number	Diff line change
`@@ -97,6 +97,7 @@`
`97`	`97`	`},`
`98`	`98`	`"resolutions": {`
`99`	`99`	`"graphql": "15.5.1",`
	`100`	`+ "esbuild": "^0.12.8",`
`100`	`101`	`"@changesets/apply-release-plan": "5.0.0"`
`101`	`102`	`}`
`102`	`103`	`}`