From ad5b046dab284d266bf7dcdefd66778c181dff5d Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 18:21:44 +0000 Subject: [PATCH 1/4] docs: unhide GraphQL API Reference page and add to overview Co-Authored-By: Devin Logan --- fern/products/docs/docs.yml | 1 - .../docs/pages/api-references/generate-graphql-ref.mdx | 3 --- fern/products/docs/pages/api-references/overview.mdx | 3 +++ .../docs/pages/api-references/generate-graphql-ref.mdx | 3 --- .../zh/products/docs/pages/api-references/overview.mdx | 3 +++ 5 files changed, 6 insertions(+), 7 deletions(-) diff --git a/fern/products/docs/docs.yml b/fern/products/docs/docs.yml index 41cd6ddac9..6be16a3f42 100644 --- a/fern/products/docs/docs.yml +++ b/fern/products/docs/docs.yml @@ -316,7 +316,6 @@ navigation: - page: GraphQL Reference path: ./pages/api-references/generate-graphql-ref.mdx slug: generate-graphql-ref - hidden: true - page: Library Reference path: ./pages/api-references/library-docs.mdx slug: library-reference diff --git a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx index 672216071b..e98754f4f2 100644 --- a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -1,11 +1,8 @@ --- title: Generate GraphQL Reference description: Use Fern Docs to generate GraphQL API Reference documentation from a GraphQL schema. -availability: pre-release --- -GraphQL API Reference is not actively maintained. [Contact us](https://buildwithfern.com/book-demo) if you have questions. - Fern generates API Reference documentation from a [GraphQL schema](https://graphql.org/learn/schema/). Add your schema file to your Fern project and Fern renders queries, mutations, subscriptions, and types as an interactive reference. ## Configuration diff --git a/fern/products/docs/pages/api-references/overview.mdx b/fern/products/docs/pages/api-references/overview.mdx index 47eac2a26b..652a439ff9 100644 --- a/fern/products/docs/pages/api-references/overview.mdx +++ b/fern/products/docs/pages/api-references/overview.mdx @@ -23,6 +23,9 @@ Fern generates interactive API Reference documentation from an [OpenAPI specific OpenRPC specification + + GraphQL schema + Python or C++ source code diff --git a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx index a4940746dc..2e62b8dbbd 100644 --- a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -2,11 +2,8 @@ title: 生成 GraphQL 参考文档 description: 使用 Fern Docs 从 GraphQL schema 生成 GraphQL API 参考文档。 sidebar-title: 生成 GraphQL 参考 -availability: pre-release --- -GraphQL API 参考文档没有积极维护。如果您有疑问，[请联系我们](https://buildwithfern.com/book-demo)。 - Fern 从 [GraphQL schema](https://graphql.org/learn/schema/) 生成 API 参考文档。将您的 schema 文件添加到 Fern 项目中，Fern 会将查询、变更、订阅和类型渲染为交互式参考文档。 ## 配置 diff --git a/fern/translations/zh/products/docs/pages/api-references/overview.mdx b/fern/translations/zh/products/docs/pages/api-references/overview.mdx index c11c29e7a4..5131e6d28a 100644 --- a/fern/translations/zh/products/docs/pages/api-references/overview.mdx +++ b/fern/translations/zh/products/docs/pages/api-references/overview.mdx @@ -23,6 +23,9 @@ Fern 从 [OpenAPI 规范](/learn/api-definitions/openapi/overview) 或其他 API OpenRPC 规范 + + GraphQL schema + Python 或 C++ 源代码 From 3cf38fed4a28d97f3cf894806cd599b5e7cbc210 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 18:36:00 +0000 Subject: [PATCH 2/4] docs: add link to GraphQL example project Co-Authored-By: Devin Logan --- .../docs/pages/api-references/generate-graphql-ref.mdx | 4 ++++ .../docs/pages/api-references/generate-graphql-ref.mdx | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx index e98754f4f2..a287d6e6ec 100644 --- a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -5,6 +5,10 @@ description: Use Fern Docs to generate GraphQL API Reference documentation from Fern generates API Reference documentation from a [GraphQL schema](https://graphql.org/learn/schema/). Add your schema file to your Fern project and Fern renders queries, mutations, subscriptions, and types as an interactive reference. + + See the [complete GraphQL example project](https://github.com/fern-api/docs-examples/tree/main/graphql) for a working configuration with a plant store schema. + + ## Configuration diff --git a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx index 2e62b8dbbd..6d41018161 100644 --- a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -6,6 +6,10 @@ sidebar-title: 生成 GraphQL 参考 Fern 从 [GraphQL schema](https://graphql.org/learn/schema/) 生成 API 参考文档。将您的 schema 文件添加到 Fern 项目中，Fern 会将查询、变更、订阅和类型渲染为交互式参考文档。 + + 查看[完整的 GraphQL 示例项目](https://github.com/fern-api/docs-examples/tree/main/graphql)，了解使用植物商店 schema 的工作配置。 + + ## 配置 From 97308bed73d9d5ab5a3b8504afb1449ba0328a7f Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 19:05:15 +0000 Subject: [PATCH 3/4] docs: link to live GraphQL example site and GitHub source Co-Authored-By: Devin Logan --- .../products/docs/pages/api-references/generate-graphql-ref.mdx | 2 +- .../products/docs/pages/api-references/generate-graphql-ref.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx index a287d6e6ec..5e0b4c4c4f 100644 --- a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -6,7 +6,7 @@ description: Use Fern Docs to generate GraphQL API Reference documentation from Fern generates API Reference documentation from a [GraphQL schema](https://graphql.org/learn/schema/). Add your schema file to your Fern project and Fern renders queries, mutations, subscriptions, and types as an interactive reference. - See the [complete GraphQL example project](https://github.com/fern-api/docs-examples/tree/main/graphql) for a working configuration with a plant store schema. + See the [live example](https://graphql.docs.buildwithfern.com) or browse the [source on GitHub](https://github.com/fern-api/docs-examples/tree/main/graphql) for a working configuration with a plant store schema. ## Configuration diff --git a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx index 6d41018161..e8b51efd0d 100644 --- a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -7,7 +7,7 @@ sidebar-title: 生成 GraphQL 参考 Fern 从 [GraphQL schema](https://graphql.org/learn/schema/) 生成 API 参考文档。将您的 schema 文件添加到 Fern 项目中，Fern 会将查询、变更、订阅和类型渲染为交互式参考文档。 - 查看[完整的 GraphQL 示例项目](https://github.com/fern-api/docs-examples/tree/main/graphql)，了解使用植物商店 schema 的工作配置。 + 查看[在线示例](https://graphql.docs.buildwithfern.com)或浏览 [GitHub 源代码](https://github.com/fern-api/docs-examples/tree/main/graphql)，了解使用植物商店 schema 的工作配置。 ## 配置 From 9035553d9605ea5a33821348e453212da80e5544 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 19:09:48 +0000 Subject: [PATCH 4/4] docs: update example callout wording and use Tip Co-Authored-By: Devin Logan --- .../docs/pages/api-references/generate-graphql-ref.mdx | 6 +++--- .../docs/pages/api-references/generate-graphql-ref.mdx | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx index 5e0b4c4c4f..0edf5ff935 100644 --- a/fern/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -5,9 +5,9 @@ description: Use Fern Docs to generate GraphQL API Reference documentation from Fern generates API Reference documentation from a [GraphQL schema](https://graphql.org/learn/schema/). Add your schema file to your Fern project and Fern renders queries, mutations, subscriptions, and types as an interactive reference. - - See the [live example](https://graphql.docs.buildwithfern.com) or browse the [source on GitHub](https://github.com/fern-api/docs-examples/tree/main/graphql) for a working configuration with a plant store schema. - + + See a [live example](https://graphql.docs.buildwithfern.com) or browse the [source on GitHub](https://github.com/fern-api/docs-examples/tree/main/graphql). + ## Configuration diff --git a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx index e8b51efd0d..49670298b1 100644 --- a/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx +++ b/fern/translations/zh/products/docs/pages/api-references/generate-graphql-ref.mdx @@ -6,9 +6,9 @@ sidebar-title: 生成 GraphQL 参考 Fern 从 [GraphQL schema](https://graphql.org/learn/schema/) 生成 API 参考文档。将您的 schema 文件添加到 Fern 项目中，Fern 会将查询、变更、订阅和类型渲染为交互式参考文档。 - - 查看[在线示例](https://graphql.docs.buildwithfern.com)或浏览 [GitHub 源代码](https://github.com/fern-api/docs-examples/tree/main/graphql)，了解使用植物商店 schema 的工作配置。 - + + 查看[在线示例](https://graphql.docs.buildwithfern.com)或浏览 [GitHub 源代码](https://github.com/fern-api/docs-examples/tree/main/graphql)。 + ## 配置