Merge remote-tracking branch 'origin/main' into 07-23-homepage-4

Author: Kapil Gowru

README.md

@@ -39,19 +39,3 @@ To run the documentation site locally:
 
 The development server will automatically reload when you make changes to the documentation files.
 
-## Open Issues 
-
-Below are links to slack conversations about what docs need to be included as part of the revamp.
-
-- https://buildwithfern.slack.com/archives/C0811KJCBL4/p1749843216981529
-- https://buildwithfern.slack.com/archives/C05J55L8JES/p1749852300828139
-- https://buildwithfern.slack.com/archives/C07EQ2VEFU5/p1750085639878549
-- https://buildwithfern.slack.com/archives/C052DFWVCG6/p1750097991824229?thread_ts=1750093356.728189&cid=C052DFWVCG6
-- Add on-prem docs to enterprise https://buildwithfern.slack.com/archives/C069FN9958X/p1750085336657299 
-- https://buildwithfern.slack.com/archives/C052DFWVCG6/p1750105603399839
-- https://buildwithfern.slack.com/archives/C06N8147J4W/p1750374966649439
-- https://buildwithfern.slack.com/archives/C08L9HGAZ2T/p1750429522110329?thread_ts=1750420489.267739&cid=C08L9HGAZ2T
-- https://buildwithfern.slack.com/archives/C06N8147J4W/p1750523650796109
-- https://buildwithfern.slack.com/archives/C06UVH9HKRC/p1750709442534809?thread_ts=1750703512.877769&cid=C06UVH9HKRCj
-- https://buildwithfern.slack.com/archives/C08T7EHDHMW/p1750793551604399?thread_ts=1750792603.757169&cid=C08T7EHDHMW
-

fern/products/api-definition/pages/introduction/what-is-the-fern-folder.mdx

@@ -1,14 +1,13 @@
 ---
 title: The Fern Folder
-description: Describes the Fern folder structure
+description: Describes the fern folder structure and its contents
 ---
 
-Configuring fern starts with the `fern` folder. The fern folder contains your API definitions,
-generators, and your CLI version.
+Configuring fern starts with the `fern` folder which contains your API definitions, generators, and your CLI version.
 
 ## Directory structure
 
-When you run `fern init`, your Fern folder will be initialized with the following files:
+When you run `fern init`, your fern folder will be initialized with the following files:
 ```bash
 fern/
   ├─ fern.config.json
@@ -35,7 +34,7 @@ the version of the Fern CLI that you are using.
 ```json
 {
     "organization": "imdb",
-    "version": "0.31.2"
+    "version": "<Markdown src="/products/sdks/snippets/fern-config-json-version.mdx"/>"
 }
 ```
 
@@ -88,7 +87,7 @@ api:
 
 ## Multiple APIs
 
-The Fern folder is capable of housing multiple API definitions. Instead of placing your API definition at the top-level, you can nest them within an `apis` folder. Be sure to include a `generators.yml` file within each API folder that specifies the location of the API definition. 
+The fern folder is capable of housing multiple API definitions. Instead of placing your API definition at the top-level, you can nest them within an `apis` folder. Be sure to include a `generators.yml` file within each API folder that specifies the location of the API definition. 
 
 <Tabs>
 <Tab title="OpenAPI Definition">

fern/products/api-definition/pages/openapi/automation.mdx

@@ -1,6 +1,6 @@
 ---
 title: Sync your OpenAPI Specification
-subtitle: Pull your latest OpenAPI Specification into your Fern Folder automatically.
+subtitle: Pull your latest OpenAPI Specification into your fern folder automatically.
 ---
 
 If you host your OpenAPI Specification at a publicly available URL, you can have Fern programmatically fetch the latest spec on a preconfigured cadence through the [sync-openapi GitHub Action](https://github.com/fern-api/sync-openapi). This ensures your committed OpenAPI spec stays up to date with your live API.
@@ -49,6 +49,6 @@ If you host your OpenAPI Specification at a publicly available URL, you can have
     Navigate to your repository's `Settings > Secrets and variables > Actions`. Select **New repository secret**, name it `OPENAPI_SYNC_TOKEN`, add your token, and click **Add secret**.
   </Step>
 </Steps>
-By default, this will create daily PRs with API spec updates to the repo containing your Fern folder. If you would like to adjust the frequency, learn more about GitHub's [schedule event](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#schedule).
+By default, this will create daily PRs with API spec updates to the repo containing your fern folder. If you would like to adjust the frequency, learn more about GitHub's [schedule event](https://docs.github.com/en/actions/reference/events-that-trigger-workflows#schedule).
 
 <Info> For detailed configuration options and other use cases, see the [sync-openapi GitHub Action README](https://github.com/fern-api/sync-openapi). </Info>

fern/products/api-definition/pages/openapi/overview.mdx

@@ -104,9 +104,9 @@ components:
       in: header
 ```
 
-## Setup your Fern folder
+## Setup your fern folder
 
-Start by initializing your Fern folder with an OpenAPI spec
+Start by initializing your fern folder with an OpenAPI spec
 
 <CodeGroup>
 ```sh file

fern/products/cli-api-reference/cli-changelog/2023-08-16.mdx

@@ -1,3 +1,3 @@
 ## 0.15.0-rc0
-**`(chore):`** - **Break**: The fern directory now has a top-level `apis` directory to handle apis and docs no longer live within an api definition
+**`(chore):`** - **Break**: The fern folder now has a top-level `apis` directory to handle apis and docs no longer live within an api definition
 

fern/products/cli-api-reference/cli-changelog/2023-11-20.mdx

@@ -11,18 +11,18 @@
 **`(chore):`** **Full Changelog**: https://github.com/fern-api/fern/compare/0.15.2-rc0...0.15.2-rc1
 
 ## 0.15.2-rc0
-**`(chore):`** ## What's Changed
-* upgrade json5 to `2.2.2` by @dsinghvi in https://github.com/fern-api/fern/pull/2304
-* chore: remove wire verification by @dsinghvi in https://github.com/fern-api/fern/pull/2305
-* chore: upgrade yaml to 2.3.3 by @dsinghvi in https://github.com/fern-api/fern/pull/2306
-* fix: `fern generate --local` with `.fernignore` fails in Github Workflow by @dsinghvi in https://github.com/fern-api/fern/pull/2307
-
-
+**`(chore):`** ## What's Changed
+* upgrade json5 to `2.2.2` by @dsinghvi in https://github.com/fern-api/fern/pull/2304
+* chore: remove wire verification by @dsinghvi in https://github.com/fern-api/fern/pull/2305
+* chore: upgrade yaml to 2.3.3 by @dsinghvi in https://github.com/fern-api/fern/pull/2306
+* fix: `fern generate --local` with `.fernignore` fails in Github Workflow by @dsinghvi in https://github.com/fern-api/fern/pull/2307
+
+
 **Full Changelog**: https://github.com/fern-api/fern/compare/0.15.1...0.15.2-rc0
 
 ## 0.15.1
-**`(chore):`** _It's been forever since we released a non release candidate!_
-
-**Break**
-- The file structure of the Fern folder has now changed. If you have a single API, your definition can live directly at the top-level. If you have multiple, they will need to live in an apis folder. When you run `fern upgrade` the directory structure will automatically be updated. 
+**`(chore):`** _It's been forever since we released a non release candidate!_
+
+**Break**
+- The file structure of the fern folder has now changed. If you have a single API, your definition can live directly at the top-level. If you have multiple, they will need to live in an apis folder. When you run `fern upgrade` the directory structure will automatically be updated. 
 

fern/products/cli-api-reference/pages/api-get-started.mdx

@@ -7,28 +7,6 @@ subtitle: 'Welcome to the Fern API reference.'
 
 The Fern API allows you to manage SDKs and code snippets using Fern's public RESTful API.
 
-## Accessing the Fern API
-
-Fern maintains official API clients for TypeScript and Python. We recommend using these clients, though the API supports any language or framework that sends HTTP requests. Let us know if you'd like an SDK in another language.
-
-<CardGroup cols={2}>
-    <Card 
-        title='TypeScript' 
-        icon={<img src="https://upload.wikimedia.org/wikipedia/commons/d/d9/Node.js_logo.svg" alt="Node.js logo"/>} 
-        href='https://github.com/fern-api/typescript-sdk'
-    >
-    API client
-    </Card>
-
-    <Card 
-        title='Python' 
-        icon={<img src="https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg" alt="Python logo"/>} 
-        href='https://github.com/fern-api/python-sdk'
-    >
-    API client
-    </Card>
-</CardGroup>
-
 ## Authentication
 
 Fern API requests require a bearer token for authentication. Use the CLI command [`fern token`](/learn/cli-api/cli-reference/commands#fern-token) to generate a bearer token. Tokens do not expire.

fern/products/docs/pages/customization/project-structure.mdx

@@ -160,7 +160,7 @@ The `fern.config.json` file specifies your organization name and the version of
 ```json
 {
   "organization": "my-organization",
-  "version": "0.55.1"
+  "version": "<Markdown src="/products/sdks/snippets/fern-config-json-version.mdx"/>"
 }
 ```
 </CodeBlock>

fern/products/docs/pages/getting-started/project-structure.mdx

@@ -160,7 +160,7 @@ The `fern.config.json` file specifies your organization name and the version of
 ```json
 {
   "organization": "my-organization",
-  "version": "0.55.1"
+  "version": "<Markdown src="/products/sdks/snippets/fern-config-json-version.mdx"/>"
 }
 ```
 </CodeBlock> 

fern/products/docs/pages/navigation/announcement-banner.mdx

@@ -10,4 +10,4 @@ announcement:
     message: "🚀 New feature: Announcements are available! (<a href=\"https://buildwithfern.com/learn/docs/building-your-docs/announcements\" target=\"_blank\">Learn more</a>) 🚀"
 ```
 
-Markdown and HTML is supported in the announcement message. You can include links, images, and other formatting. [Custom css](/learn/docs/building-your-docs/custom-css-global-js#custom-css) can be used to customize the style of the announcement.
+Markdown and HTML is supported in the announcement message. You can include links, images, and other formatting. [Custom CSS](/learn/docs/building-your-docs/custom-css-global-js#custom-css) can be used to customize the style of the announcement.