From 4454174acca5075f9ae55a4fec5794a7492ee72a Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 20 Oct 2025 21:27:26 +0000 Subject: [PATCH 1/5] Add clarification for http-snippets configuration with curl-only example Co-Authored-By: danny@buildwithfern.com --- .../products/docs/pages/api-references/http-snippets.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/fern/products/docs/pages/api-references/http-snippets.mdx b/fern/products/docs/pages/api-references/http-snippets.mdx index 49918fc84..9cb9b8341 100644 --- a/fern/products/docs/pages/api-references/http-snippets.mdx +++ b/fern/products/docs/pages/api-references/http-snippets.mdx @@ -24,9 +24,18 @@ settings: http-snippets: - python - ruby + +# Enable only curl (useful when you want HTTP examples but not other languages) +settings: + http-snippets: + - curl ``` + +If you want to keep HTTP snippets enabled but only show curl examples, use `http-snippets: [curl]` instead of `http-snippets: false`. Setting it to `false` disables all HTTP snippets completely. + + ## How It Works ### Request Examples From 42b28dedb7b6117aa33ee57be2cf017507782744 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 20 Oct 2025 21:33:09 +0000 Subject: [PATCH 2/5] Update: clarify that curl is always shown by default - curl is now always included in HTTP snippets regardless of configuration - Updated examples to show curl is always present - Added note that custom CSS is needed to hide curl from UI Co-Authored-By: danny@buildwithfern.com --- .../docs/pages/api-references/http-snippets.mdx | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/fern/products/docs/pages/api-references/http-snippets.mdx b/fern/products/docs/pages/api-references/http-snippets.mdx index 9cb9b8341..683a42f13 100644 --- a/fern/products/docs/pages/api-references/http-snippets.mdx +++ b/fern/products/docs/pages/api-references/http-snippets.mdx @@ -10,30 +10,25 @@ subtitle: HTTP snippets allow users to see API request examples using common HTT ## Configuration -HTTP snippets are enabled by default for all documentation sites. To disable snippets or enable only for certain languages, use the `settings.http-snippets` configuration in your `docs.yml` file: +HTTP snippets are enabled by default for all documentation sites. **curl is always included in HTTP snippets and cannot be disabled via configuration.** To control other HTTP snippet languages, use the `settings.http-snippets` configuration in your `docs.yml` file: ```yaml -# Turn off HTTP snippets for all languages +# Disable all HTTP snippets except curl (curl is always shown) settings: http-snippets: false -# Enable only for specific languages (here, only Python and Ruby) +# Enable only specific languages (curl is always shown in addition to these) settings: http-snippets: - python - ruby - -# Enable only curl (useful when you want HTTP examples but not other languages) -settings: - http-snippets: - - curl ``` -If you want to keep HTTP snippets enabled but only show curl examples, use `http-snippets: [curl]` instead of `http-snippets: false`. Setting it to `false` disables all HTTP snippets completely. +curl is always displayed in the HTTP snippets selector, regardless of your `http-snippets` configuration. To hide curl from the UI, you would need to use custom CSS. ## How It Works From 7a8f24a71bd97dca95ca732292b679dcad9a300b Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Mon, 20 Oct 2025 22:02:55 +0000 Subject: [PATCH 3/5] Fix Vale style issues: use active voice and contractions - Changed 'cannot' to 'can't' (Microsoft.Contractions) - Rewrote sentence in active voice to avoid passive constructions - Replaced 'disabled' with 'remove' to avoid accessibility language - Changed 'are enabled' to 'include' for active voice Co-Authored-By: danny@buildwithfern.com --- fern/products/docs/pages/api-references/http-snippets.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/docs/pages/api-references/http-snippets.mdx b/fern/products/docs/pages/api-references/http-snippets.mdx index 683a42f13..52de433cc 100644 --- a/fern/products/docs/pages/api-references/http-snippets.mdx +++ b/fern/products/docs/pages/api-references/http-snippets.mdx @@ -10,7 +10,7 @@ subtitle: HTTP snippets allow users to see API request examples using common HTT ## Configuration -HTTP snippets are enabled by default for all documentation sites. **curl is always included in HTTP snippets and cannot be disabled via configuration.** To control other HTTP snippet languages, use the `settings.http-snippets` configuration in your `docs.yml` file: +All documentation sites include HTTP snippets by default. **curl always appears in HTTP snippets and you can't remove it via configuration.** To control other HTTP snippet languages, use the `settings.http-snippets` configuration in your `docs.yml` file: From 8cd8e9124e39829762212b4f593b79494121b846 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Mon, 20 Oct 2025 18:31:01 -0400 Subject: [PATCH 4/5] fix callout and tighten language --- .../docs/pages/api-references/http-snippets.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/fern/products/docs/pages/api-references/http-snippets.mdx b/fern/products/docs/pages/api-references/http-snippets.mdx index 52de433cc..42de71f67 100644 --- a/fern/products/docs/pages/api-references/http-snippets.mdx +++ b/fern/products/docs/pages/api-references/http-snippets.mdx @@ -10,16 +10,20 @@ subtitle: HTTP snippets allow users to see API request examples using common HTT ## Configuration -All documentation sites include HTTP snippets by default. **curl always appears in HTTP snippets and you can't remove it via configuration.** To control other HTTP snippet languages, use the `settings.http-snippets` configuration in your `docs.yml` file: +All documentation sites include HTTP snippets by default. To control which languages appear in the HTTP snippet selector, use the `settings.http-snippets` configuration in your `docs.yml` file. + + + curl is always displayed in the HTTP snippets selector and cannot be removed via `docs.yml` configuration. To hide it, [use custom CSS](/docs/customization/custom-css-js#custom-css). + ```yaml -# Disable all HTTP snippets except curl (curl is always shown) +# Disable all HTTP snippets except curl settings: http-snippets: false -# Enable only specific languages (curl is always shown in addition to these) +# Enable only specific languages (in addition to curl) settings: http-snippets: - python @@ -27,10 +31,6 @@ settings: ``` - -curl is always displayed in the HTTP snippets selector, regardless of your `http-snippets` configuration. To hide curl from the UI, you would need to use custom CSS. - - ## How It Works ### Request Examples From c5a15f55f0c8f9361e927cebdb03b20cc97ba5bc Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Mon, 20 Oct 2025 18:31:35 -0400 Subject: [PATCH 5/5] language fix --- fern/products/docs/pages/api-references/http-snippets.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/docs/pages/api-references/http-snippets.mdx b/fern/products/docs/pages/api-references/http-snippets.mdx index 42de71f67..35a8a6447 100644 --- a/fern/products/docs/pages/api-references/http-snippets.mdx +++ b/fern/products/docs/pages/api-references/http-snippets.mdx @@ -13,7 +13,7 @@ subtitle: HTTP snippets allow users to see API request examples using common HTT All documentation sites include HTTP snippets by default. To control which languages appear in the HTTP snippet selector, use the `settings.http-snippets` configuration in your `docs.yml` file. - curl is always displayed in the HTTP snippets selector and cannot be removed via `docs.yml` configuration. To hide it, [use custom CSS](/docs/customization/custom-css-js#custom-css). + curl is always displayed in the HTTP snippets selector and can't be removed via `docs.yml` configuration. To hide it, [use custom CSS](/docs/customization/custom-css-js#custom-css).