Skip to content

Commit

Permalink
fix(docs): update documentation (#5390)
Browse files Browse the repository at this point in the history
  • Loading branch information
emretezisci authored Dec 12, 2024
1 parent 14ab858 commit 4936e19
Showing 1 changed file with 13 additions and 9 deletions.
22 changes: 13 additions & 9 deletions fern/pages/sdks/comparison/speakeasy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ walk through the different capabilities of Fern and Speakeasy.

### 1. Fern is an all-in-one: SDKs + Docs

If you choose Speakeasy, you'll have to find a separate docs vendor such as ReadMe. With Fern, you'll be able to generate SDKs and
If you choose Speakeasy, you can integrate with third-party documentation providers or use its native Scalar integration. With Fern, you'll be able to generate SDKs and
Docs with embedded code snippets.

<Frame caption="API Docs with SDK code snippets (generated by Fern)">
Expand All @@ -21,8 +21,8 @@ Fern's SDKs are battle-tested and have been downloaded millions of times.

| Language | Fern | Speakeasy |
| ---------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| TypeScript | **93k** weekly downloads ([Cohere](https://www.npmjs.com/package/cohere-ai)) | **5k** weekly downloads ([Unstructured](https://www.npmjs.com/package/unstructured-client)) |
| Python | **5 million** lifetime downloads ([ElevenLabs](https://github.com/elevenlabs/elevenlabs-python)) | **194k** lifetime downloads ([Airbyte](https://github.com/airbytehq/airbyte-api-python-sdk)) |
| TypeScript | **120k** weekly downloads ([Cohere](https://www.npmjs.com/package/cohere-ai)) | **85k** weekly downloads ([Mistral AI](https://www.npmjs.com/package/@mistralai/mistralai)) |
| Python | **6 million** lifetime downloads ([ElevenLabs](https://pepy.tech/projects/ElevenLabs)) | **17 million** lifetime downloads ([Unstructured](https://pepy.tech/projects/unstructured-client)) |

### 3. Fern offers more Generally Available SDK languages.

Expand All @@ -33,7 +33,11 @@ Fern's SDKs are battle-tested and have been downloaded millions of times.
| Java |||
| Go |||
| C# |||
| PHP |||
| Terraform |||
| Ruby || ❌ (Alpha) |
| Unity || ❌ (Beta) |


### 4. Speakeasy generates Terraform providers.

Expand All @@ -49,7 +53,7 @@ is blocked if any failures are encountered.
<img src="./fern-tests.png" />
</Frame>

On the other hand, Speakeasy produces no tests in their SDKs ([example](https://github.com/airbytehq/airbyte-api-python-sdk)).
On the other hand, Speakeasy supports contract testing, server mocking, and API sequence testing to streamline development workflows. ([example](https://www.speakeasy.com/docs/testing)).

### 6. Fern supports OAuth + DPoP.

Expand All @@ -58,8 +62,8 @@ On the other hand, Speakeasy produces no tests in their SDKs ([example](https://
| `Bearer` |||
| `Basic` |||
| Custom Headers |||
| `OAuth` Client Credentials || 🏗️ Partial |
| `OAuth` Refresh || 🏗️ Partial |
| `OAuth` Client Credentials || |
| `OAuth` Refresh || |
| DPop (Proof of possession) |||

### 7. Fern's file structure is resource based.
Expand Down Expand Up @@ -91,6 +95,6 @@ behavior.

| Feature | Fern | Speakeasy |
| ---------------- | ---- | --------- |
| Auth Override || |
| Timeout Override || |
| Retry Override || |
| Auth Override || |
| Timeout Override || |
| Retry Override || |

0 comments on commit 4936e19

Please sign in to comment.