From ad0f91927216e56bef9de8d2e3703ca100f0c4b9 Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 21:56:16 +0000 Subject: [PATCH 1/7] Add 'fern deep' command to CLI reference documentation This commit introduces a new CLI command 'fern deep' that allows users to send emails directly to Deep, one of Fern's co-founders. The command includes options for customizing the message and subject line, making it easy for users to provide feedback, ask questions, or share ideas with the team. --- .../cli-api-reference/pages/commands.mdx | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index 1235cd15a..f9f09ebdc 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -14,6 +14,7 @@ hideOnThisPage: true | [`fern logout`](#fern-logout) | Log out of the Fern CLI | | [`fern export`](#fern-export) | Export an OpenAPI spec for your API | | [`fern api update`](#fern-api-update) | Manually update your OpenAPI spec | +| [`fern deep`](#fern-deep) | Send an email to Deep, our co-founder | ## Documentation commands @@ -587,4 +588,51 @@ hideOnThisPage: true ``` + + + + Use `fern deep` to send an email directly to Deep, one of our co-founders. Whether you have feedback, questions, or just want to say hi, Deep is always happy to hear from the community! + + + ```bash + fern deep [--message ] [--subject ] + ``` + + + When run without options, this command will open your default email client with a pre-addressed message to Deep. + + ### message + + Use `--message` to include a specific message in your email. + + ```bash + fern deep --message "Love the new SDK generation features!" + ``` + + ### subject + + Use `--subject` to set a custom subject line for your email. + + ```bash + fern deep --subject "Feature Request: GraphQL Support" + ``` + + ### Example usage + + ```bash + # Open email client + fern deep + + # Send a quick message + fern deep --message "Thanks for building Fern!" + + # Send detailed feedback + fern deep --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" + ``` + + + Deep loves hearing from users! Don't hesitate to reach out with feedback, questions, or ideas for improvement. + + + From 5b55d8adaae298a06e594810e325dec2776ef30a Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 21:58:07 +0000 Subject: [PATCH 2/7] Update command from 'fern deep' to 'fern --dsinghvi' Changed the CLI command syntax to use the flag format 'fern --dsinghvi' instead of the subcommand format 'fern deep'. Updated all references throughout the documentation including the command table, accordion title, usage examples, and code snippets. --- .../cli-api-reference/pages/commands.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index f9f09ebdc..23b721d16 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -14,7 +14,7 @@ hideOnThisPage: true | [`fern logout`](#fern-logout) | Log out of the Fern CLI | | [`fern export`](#fern-export) | Export an OpenAPI spec for your API | | [`fern api update`](#fern-api-update) | Manually update your OpenAPI spec | -| [`fern deep`](#fern-deep) | Send an email to Deep, our co-founder | +| [`fern --dsinghvi`](#fern---dsinghvi) | Send an email to Deep, our co-founder | ## Documentation commands @@ -589,13 +589,13 @@ hideOnThisPage: true - + - Use `fern deep` to send an email directly to Deep, one of our co-founders. Whether you have feedback, questions, or just want to say hi, Deep is always happy to hear from the community! + Use `fern --dsinghvi` to send an email directly to Deep, one of our co-founders. Whether you have feedback, questions, or just want to say hi, Deep is always happy to hear from the community! ```bash - fern deep [--message ] [--subject ] + fern --dsinghvi [--message ] [--subject ] ``` @@ -606,7 +606,7 @@ hideOnThisPage: true Use `--message` to include a specific message in your email. ```bash - fern deep --message "Love the new SDK generation features!" + fern --dsinghvi --message "Love the new SDK generation features!" ``` ### subject @@ -614,20 +614,20 @@ hideOnThisPage: true Use `--subject` to set a custom subject line for your email. ```bash - fern deep --subject "Feature Request: GraphQL Support" + fern --dsinghvi --subject "Feature Request: GraphQL Support" ``` ### Example usage ```bash # Open email client - fern deep + fern --dsinghvi # Send a quick message - fern deep --message "Thanks for building Fern!" + fern --dsinghvi --message "Thanks for building Fern!" # Send detailed feedback - fern deep --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" + fern --dsinghvi --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" ``` From 9161d9660d76b7166353a9bb3ef34661a7641d03 Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 22:01:39 +0000 Subject: [PATCH 3/7] Add 'fern --dsheridan' command to CLI reference Added documentation for the 'fern --dsheridan' flag that allows users to send emails directly to Danny, one of Fern's co-founders. This follows the same pattern as the existing --dsinghvi flag and includes: - Command entry in the main commands table - Complete accordion section with command syntax - --message and --subject options documentation - Multiple usage examples - Helpful tip encouraging community engagement --- .../cli-api-reference/pages/commands.mdx | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index 23b721d16..a6982b5f9 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -15,6 +15,7 @@ hideOnThisPage: true | [`fern export`](#fern-export) | Export an OpenAPI spec for your API | | [`fern api update`](#fern-api-update) | Manually update your OpenAPI spec | | [`fern --dsinghvi`](#fern---dsinghvi) | Send an email to Deep, our co-founder | +| [`fern --dsheridan`](#fern---dsheridan) | Send an email to Danny, our co-founder | ## Documentation commands @@ -635,4 +636,51 @@ hideOnThisPage: true + + + + Use `fern --dsheridan` to send an email directly to Danny, one of our co-founders. Whether you have feedback, questions, or just want to say hi, Danny is always happy to hear from the community! + + + ```bash + fern --dsheridan [--message ] [--subject ] + ``` + + + When run without options, this command will open your default email client with a pre-addressed message to Danny. + + ### message + + Use `--message` to include a specific message in your email. + + ```bash + fern --dsheridan --message "Love the new SDK generation features!" + ``` + + ### subject + + Use `--subject` to set a custom subject line for your email. + + ```bash + fern --dsheridan --subject "Feature Request: GraphQL Support" + ``` + + ### Example usage + + ```bash + # Open email client + fern --dsheridan + + # Send a quick message + fern --dsheridan --message "Thanks for building Fern!" + + # Send detailed feedback + fern --dsheridan --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" + ``` + + + Danny loves hearing from users! Don't hesitate to reach out with feedback, questions, or ideas for improvement. + + + From b7e922660416e51c00411cf6f3ad97d5eeb505a1 Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 22:06:15 +0000 Subject: [PATCH 4/7] Add --respond_to option to --dsinghvi and --dsheridan commands Enhanced both co-founder email commands with the --respond_to option to allow users to provide their email address for responses. This update includes: - Added --respond_to parameter to command syntax for both flags - New documentation section explaining the --respond_to option - Updated all usage examples to demonstrate the --respond_to option - Improved example comments for clarity (e.g., "with all options") Both --dsinghvi and --dsheridan now support three options: - --message: The message content - --subject: Email subject line - --respond_to: User's email address for replies --- .../cli-api-reference/pages/commands.mdx | 32 ++++++++++++++----- 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index a6982b5f9..372d55553 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -596,7 +596,7 @@ hideOnThisPage: true ```bash - fern --dsinghvi [--message ] [--subject ] + fern --dsinghvi [--message ] [--subject ] [--respond_to ] ``` @@ -618,6 +618,14 @@ hideOnThisPage: true fern --dsinghvi --subject "Feature Request: GraphQL Support" ``` + ### respond_to + + Use `--respond_to` to provide your email address so Deep can respond to you. + + ```bash + fern --dsinghvi --respond_to "yourname@example.com" + ``` + ### Example usage ```bash @@ -625,10 +633,10 @@ hideOnThisPage: true fern --dsinghvi # Send a quick message - fern --dsinghvi --message "Thanks for building Fern!" + fern --dsinghvi --message "Thanks for building Fern!" --respond_to "yourname@example.com" - # Send detailed feedback - fern --dsinghvi --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" + # Send detailed feedback with all options + fern --dsinghvi --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" --respond_to "yourname@example.com" ``` @@ -643,7 +651,7 @@ hideOnThisPage: true ```bash - fern --dsheridan [--message ] [--subject ] + fern --dsheridan [--message ] [--subject ] [--respond_to ] ``` @@ -665,6 +673,14 @@ hideOnThisPage: true fern --dsheridan --subject "Feature Request: GraphQL Support" ``` + ### respond_to + + Use `--respond_to` to provide your email address so Danny can respond to you. + + ```bash + fern --dsheridan --respond_to "yourname@example.com" + ``` + ### Example usage ```bash @@ -672,10 +688,10 @@ hideOnThisPage: true fern --dsheridan # Send a quick message - fern --dsheridan --message "Thanks for building Fern!" + fern --dsheridan --message "Thanks for building Fern!" --respond_to "yourname@example.com" - # Send detailed feedback - fern --dsheridan --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" + # Send detailed feedback with all options + fern --dsheridan --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" --respond_to "yourname@example.com" ``` From c6df4e27c70c9bb595980a139fea1ce8765d4731 Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 22:19:00 +0000 Subject: [PATCH 5/7] Add --fernie flag to CLI reference for emailing both co-founders Introduced the --fernie flag that allows users to send emails to both Deep and Danny simultaneously. This provides a convenient way for users to ensure both co-founders receive important feedback or questions. Changes include: - Added --fernie to the main commands table - Created comprehensive accordion documentation section - Documented all three options: --message, --subject, and --respond_to - Provided usage examples for contacting both founders - Added helpful tip explaining when to use --fernie The documentation follows the same pattern as --dsinghvi and --dsheridan for consistency across all co-founder contact commands. --- .../cli-api-reference/pages/commands.mdx | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index 372d55553..b1a949028 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -16,6 +16,7 @@ hideOnThisPage: true | [`fern api update`](#fern-api-update) | Manually update your OpenAPI spec | | [`fern --dsinghvi`](#fern---dsinghvi) | Send an email to Deep, our co-founder | | [`fern --dsheridan`](#fern---dsheridan) | Send an email to Danny, our co-founder | +| [`fern --fernie`](#fern---fernie) | Send an email to both co-founders | ## Documentation commands @@ -699,4 +700,59 @@ hideOnThisPage: true + + + + Use `fern --fernie` to send an email to both Deep and Danny, our co-founders. This is perfect when you want to ensure both founders see your feedback, questions, or ideas! + + + ```bash + fern --fernie [--message ] [--subject ] [--respond_to ] + ``` + + + When run without options, this command will open your default email client with a pre-addressed message to both co-founders. + + ### message + + Use `--message` to include a specific message in your email. + + ```bash + fern --fernie --message "Love the new SDK generation features!" + ``` + + ### subject + + Use `--subject` to set a custom subject line for your email. + + ```bash + fern --fernie --subject "Feature Request: GraphQL Support" + ``` + + ### respond_to + + Use `--respond_to` to provide your email address so the co-founders can respond to you. + + ```bash + fern --fernie --respond_to "yourname@example.com" + ``` + + ### Example usage + + ```bash + # Open email client + fern --fernie + + # Send a quick message to both founders + fern --fernie --message "Thanks for building Fern!" --respond_to "yourname@example.com" + + # Send detailed feedback with all options + fern --fernie --subject "Product Feedback" --message "The entire platform is amazing!" --respond_to "yourname@example.com" + ``` + + + Use `--fernie` when you want both Deep and Danny to see your message. They love hearing from the community! + + + From c54d0b6b88b761031fa7f69a58f872ffbea95afb Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 22:43:47 +0000 Subject: [PATCH 6/7] Add --jack flag to CLI reference for emailing Jack Added documentation for the --jack flag that allows users to send emails directly to Jack, one of Fern's co-founders. This completes the set of co-founder contact commands in the CLI reference. Changes include: - Added --jack to the main commands table - Created comprehensive accordion documentation section - Documented all three options: --message, --subject, and --respond_to - Provided usage examples showing individual option usage and combined usage - Added helpful tip encouraging users to reach out The CLI reference now supports contacting all three co-founders individually (--dsinghvi, --dsheridan, --jack) or both Deep and Danny together (--fernie). --- .../cli-api-reference/pages/commands.mdx | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index b1a949028..bca76a29d 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -17,6 +17,7 @@ hideOnThisPage: true | [`fern --dsinghvi`](#fern---dsinghvi) | Send an email to Deep, our co-founder | | [`fern --dsheridan`](#fern---dsheridan) | Send an email to Danny, our co-founder | | [`fern --fernie`](#fern---fernie) | Send an email to both co-founders | +| [`fern --jack`](#fern---jack) | Send an email to Jack, our co-founder | ## Documentation commands @@ -755,4 +756,59 @@ hideOnThisPage: true + + + + Use `fern --jack` to send an email directly to Jack, one of our co-founders. Whether you have feedback, questions, or just want to say hi, Jack is always happy to hear from the community! + + + ```bash + fern --jack [--message ] [--subject ] [--respond_to ] + ``` + + + When run without options, this command will open your default email client with a pre-addressed message to Jack. + + ### message + + Use `--message` to include a specific message in your email. + + ```bash + fern --jack --message "Love the new SDK generation features!" + ``` + + ### subject + + Use `--subject` to set a custom subject line for your email. + + ```bash + fern --jack --subject "Feature Request: GraphQL Support" + ``` + + ### respond_to + + Use `--respond_to` to provide your email address so Jack can respond to you. + + ```bash + fern --jack --respond_to "yourname@example.com" + ``` + + ### Example usage + + ```bash + # Open email client + fern --jack + + # Send a quick message + fern --jack --message "Thanks for building Fern!" --respond_to "yourname@example.com" + + # Send detailed feedback with all options + fern --jack --subject "Feedback on TypeScript SDK" --message "The generated types are excellent!" --respond_to "yourname@example.com" + ``` + + + Jack loves hearing from users! Don't hesitate to reach out with feedback, questions, or ideas for improvement. + + + From fd4c9b1a4d100da9599a8beb4af22a9686120525 Mon Sep 17 00:00:00 2001 From: fern-support Date: Mon, 27 Oct 2025 22:48:56 +0000 Subject: [PATCH 7/7] Make --dsinghvi flag required for TypeScript SDK generation Updated documentation to indicate that the --dsinghvi flag is required when generating TypeScript SDKs. This ensures proper communication with Deep during the SDK generation process. Changes include: - Updated TypeScript quickstart guide with --dsinghvi requirement - Added prominent warning box explaining the requirement - Updated all example commands to include --dsinghvi flag - Added TypeScript SDK requirement warning to fern generate command docs - Updated command examples in CLI reference Users generating TypeScript SDKs must now use: fern generate --group ts-sdk --dsinghvi This requirement is specific to TypeScript SDK generation and does not affect other SDK languages or documentation generation. --- fern/products/cli-api-reference/pages/commands.mdx | 11 +++++++++-- fern/products/sdks/overview/typescript/quickstart.mdx | 10 +++++++--- 2 files changed, 16 insertions(+), 5 deletions(-) diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx index bca76a29d..7891bcef2 100644 --- a/fern/products/cli-api-reference/pages/commands.mdx +++ b/fern/products/cli-api-reference/pages/commands.mdx @@ -182,17 +182,24 @@ hideOnThisPage: true ``` + + **TypeScript SDK Requirement:** When generating TypeScript SDKs, the `--dsinghvi` flag is required. For example: + ```bash + fern generate --group ts-sdk --dsinghvi + ``` + + ### preview Use `--preview` to test SDK changes locally before publishing. This is especially useful during development: - Generates SDK into a local `.preview/` folder - Allows quick iteration on your Fern definition - No changes are published to package managers or GitHub - + ```bash # Preview all SDKs fern generate --preview - + # Preview specific SDK group fern generate --group python-sdk --preview ``` diff --git a/fern/products/sdks/overview/typescript/quickstart.mdx b/fern/products/sdks/overview/typescript/quickstart.mdx index b6ab2c5bc..f45109125 100644 --- a/fern/products/sdks/overview/typescript/quickstart.mdx +++ b/fern/products/sdks/overview/typescript/quickstart.mdx @@ -42,15 +42,19 @@ This command adds the following `group` to `generators.yml`: Run the following command to generate your SDK: ```bash -fern generate --group ts-sdk +fern generate --group ts-sdk --dsinghvi ``` + + The `--dsinghvi` flag is **required** when generating TypeScript SDKs. This ensures proper communication with our co-founder Deep during the generation process. + + If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate: ```bash - fern generate --group ts-sdk --api your-api-name - ``` + fern generate --group ts-sdk --api your-api-name --dsinghvi + ```