feat: added redirects for most of sdk pages

Author: Kapil Gowru

fern/assets/styles.css

@@ -212,6 +212,152 @@
 
 /*** END -- PRODUCT SELECTOR STYLING ***/
 
+/*** START -- DOCS HOMEPAGE STYLING ***/
+.docs-homepage {
+  position: relative;
+  .fern-card {
+    text-decoration: none !important;
+  } 
+
+
+  .dashed-pattern-left {
+    position: absolute;
+    left: -4rem;
+    top: -8.5rem;
+    height: calc(100% + 26rem);
+    width: 1rem;
+    opacity: 1;
+    pointer-events: none;
+    border-right: 1px solid var(--grayscale-5);
+    mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0 ) 100%);
+    -webkit-mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+  }
+
+  .dashed-pattern-right {
+    position: absolute;
+    right: -4rem;
+    top: -8.5rem;
+    height: calc(100% + 26rem);
+    width: 1rem;
+    opacity: 1;
+    pointer-events: none;
+    border-left: 1px solid var(--grayscale-5);
+    mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+    -webkit-mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+  }
+
+
+  .fern-card {
+    border: none !important;
+    padding: 0 !important;
+    box-shadow: none !important;
+    background-color: transparent !important;
+
+    .card-title {
+      display: flex;
+      gap: 0.25rem;
+      align-items: center;
+    }
+
+    img {
+      transition: transform 0.15s ease-in-out;
+    }
+
+    .arrow-right {
+      height: 1rem;
+      opacity: 0;
+      transition: opacity 0.15s ease-in-out, transform 0.15s ease-in-out;
+      transform: translateX(0px);
+    }
+
+    &:hover {
+      img {
+        transform: scale(1.01);
+      }
+
+      .arrow-right {
+        opacity: 1;
+        transform: translateX(2px);
+      }
+    }
+  }
+}
+/*** END -- DOCS HOMEPAGE STYLING ***/
+
+/*** START -- SDKS HOMEPAGE STYLING ***/
+  .sdks-homepage {
+    position: relative;
+
+    .fern-card {
+      text-decoration: none !important;
+    } 
+
+    .dashed-pattern-left {
+      position: absolute;
+      left: -4rem;
+      top: -8.5rem;
+      height: calc(100% + 26rem);
+      width: 1rem;
+      opacity: 1;
+      pointer-events: none;
+      border-right: 1px solid var(--grayscale-5);
+      mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0 ) 100%);
+      -webkit-mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+    }
+
+    .dashed-pattern-right {
+      position: absolute;
+      right: -4rem;
+      top: -8.5rem;
+      height: calc(100% + 26rem);
+      width: 1rem;
+      opacity: 1;
+      pointer-events: none;
+      border-left: 1px solid var(--grayscale-5);
+      mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+      -webkit-mask: linear-gradient(to bottom, transparent 0%, rgba(0,0,0,1) 10%, rgba(0,0,0,1) 90%, rgba(0,0,0,0) 100%);
+    }
+
+    .fern-card {
+      border: none !important;
+      padding: 0 !important;
+      box-shadow: none !important;
+      background-color: transparent !important;
+
+      .external-link-icon {
+        display: none !important;
+      }
+
+      .card-title {
+        display: flex;
+        gap: 0.25rem;
+        align-items: center;
+      }
+
+      img {
+        transition: transform 0.15s ease-in-out;
+      }
+
+      .arrow-right {
+        height: 1rem;
+        opacity: 0;
+        transition: opacity 0.15s ease-in-out, transform 0.15s ease-in-out;
+        transform: translateX(0px);
+      }
+
+      &:hover {
+        img {
+          transform: scale(1.01);
+        }
+
+        .arrow-right {
+          opacity: 1;
+          transform: translateX(2px);
+        }
+      }
+    }
+  }
+/*** START -- SDKS HOMEPAGE STYLING ***/
 
 /*** START -- LANDING PAGE STYLING ***/
 :is(.dark) {

fern/docs.yml

@@ -27,7 +27,7 @@ products:
 
   - display-name: Ask Fern
     path: ./products/ask-fern/ask-fern.yml
-    icon: fa-regular fa-magnifying-glass
+    icon: fa-regular fa-magnifying-glass  
     image: ./images/product-switcher/product-switcher-askfern-light.png
     slug: ask-fern
     subtitle: Let users find answers in your documentation instantly
@@ -150,26 +150,62 @@ analytics:
 # Redirects for new docs structure migration
 redirects:
   - source: /learn/welcome
-    destination: /learn
+    destination: /learn/home
     permanent: true
-  - source: /learn/home
-    destination: /learn
+  - source: /learn
+    destination: /learn/home
     permanent: true
   - source: /learn/api-definition/fern/api-yml-reference
     destination: /learn/api-definition/fern/api-yml/overview
     permanent: true
+  - source: /learn/docs/api-references/api-explorer
+    destination: /learn/docs/api-references/api-explorer/overview
   - source: /learn/docs/api-references/api-playground/:slug*
-    destination: /learn/docs/api-references/api-explorer/:slug*
+    destination: learn/docs/api-references/api-explorer/:slug*
     permanent: true
   - source: /learn/docs/api-references/api-playground
-    destination: /learn/docs/api-references/api-explorer
+    destination: /learn/docs/api-references/api-explorer/overview
     permanent: true
   - source: /learn/sdks/features/:slug*
     destination: /learn/sdks/capabilities/:slug*
     permanent: true
+  - source: /learn/sdks/capabilities/method-names
+    destination: /learn/sdks/deep-dives/customize-method-names
+    permanent: true
+  - source: /learn/sdks/guides/preview-your-sdk-locally
+    destination: /learn/sdks/deep-dives/setup-local-sdk-previews
+    permanent: true
+  - source: /learn/sdks/capabilities/auto-pagination
+    destination: /learn/v2/sdks/deep-dives/configure-auto-pagination
+    permanent: true
+  - source: /learn/sdks/capabilities/idempotency-headers
+    destination: /learn/sdks/deep-dives/configure-idempotency
+    permanent: true
   - source: /learn/sdks/package-managers/:slug*
     destination: /learn/sdks/guides/publish-to-package-managers/:slug*
     permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/npm-type-script
+    destination: /learn/sdks/generators/type-script/publishing-to-npm
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/pypi
+    destination: /learn/sdks/generators/python/publishing-to-py-pi
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/nuget
+    destination: /learn/sdks/generators/net/publishing-to-nu-get
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/pkgsite
+    destination: /learn/sdks/generators/go/publishing-as-a-go-module
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/maven-central
+    destination: /learn/sdks/generators/java/publishing-to-maven-central
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/rubygems
+    destination: /learn/sdks/generators/ruby/publishing-to-rubygems
+    permanent: true
+  - source: /learn/sdks/guides/publish-to-package-managers/packagist
+    destination: /learn/sdks/generators/php/publishing-to-packagist
+    permanent: true
+  # PAUSED HERE
   - source: /learn/sdks/introduction/configuration
     destination: /learn/sdks/introduction/language-support
     permanent: true

fern/images/product-switcher/api-definitions-dark.png

@@ -60,7 +60,7 @@ navigation:
       - page: Overlay Customizations
         icon: fa-regular fa-shuffle
         path: ./pages/openapi/overrides.mdx
-      - page: Automatic Updates
+      - page: Sync your OpenAPI Specification
         icon: fa-regular fa-arrows-rotate
         path: ./pages/openapi/automation.mdx            
       - section: Integrate your Server Framework
@@ -150,4 +150,4 @@ navigation:
       - page: Export to OpenAPI
         icon: fa-regular fa-file-export
         slug: export-openapi
-        path: ./pages/fern-definition/export-openapi.mdx
+        path: ./pages/fern-definition/export-openapi.mdx

fern/images/product-switcher/api-definitions-light.png

@@ -29,7 +29,7 @@ service:
 ## Receiving bytes
 
 <Note>
-  When handling binary data in responses, use `type: file` instead of `type: bytes`. The `bytes` type is only supported in requests.
+  When handling binary data in responses, use `type: file` instead of `type: bytes`.
 </Note>
 
 On the other hand, if your API is returning a stream of bytes, then you can leverage the `bytes` type as a response.

fern/images/product-switcher/cli-api-reference-dark.png

@@ -1,12 +1,54 @@
 ---
-title: Automatically Update
+title: Sync your OpenAPI Specification
 subtitle: Pull your latest OpenAPI Specification into your Fern Folder automatically.
 ---
 
-If you host your OpenAPI Specification at a publically available URL, you can have Fern programmatically fetch the latest spec on a preconfigured cadence. By default, this will be done every day and open a new PR on the GitHub repo that contains your Fern Folder. This feature requires installation of the [Fern GitHub App](https://github.com/apps/fern-api).
-
-```yml title="generators.yml"
-api:
-  path: openapi/openapi.json
-  origin: https://example.com/openapi.json
+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.
+## Setup
+<Steps>
+  <Step title="Configure the origin URL">
+   Add the origin field to your generators.yml to specify where your OpenAPI spec is hosted:
+   ```yml title="generators.yml"
+    api:
+      path: openapi/openapi.json
+      origin: https://api.example.com/openapi.json
+    ```
+  </Step>
+  <Step title="Add the GitHub Action">
+    Create `.github/workflows/sync-openapi.yml` in your repository:
+    ```yml
+    name: Sync OpenAPI Specs # can be customized
+    on:                               # additional custom triggers can be configured
+      workflow_dispatch:              # manual dispatch
+      push:                                          
+        branches:
+          - main                      # on push to main
+      schedule:
+        - cron: '0 3 * * *'           # everyday at 3:00 AM UTC
+  jobs:
+    update-from-source:
+      runs-on: ubuntu-latest
+      steps:
+        - uses: actions/checkout@v4
+          with:
+            token: ${{ secrets.OPENAPI_SYNC_TOKEN }}
+        - name: Update API with Fern
+          uses: fern-api/sync-openapi@v2
+          with:
+            update_from_source: true
+            token: ${{ secrets.OPENAPI_SYNC_TOKEN }}
+            branch: 'update-api'
+            auto_merge: false
+            add_timestamp: true
 ```
+  </Step>
+  <Step title="Add a GitHub token">
+    Generate a [fine-grained personal access token](https://github.com/settings/personal-access-tokens) with read/write access to your repository.
+  </Step>
+  <Step title="Add to Repository Secrets">
+    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).
+
+<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/images/product-switcher/cli-api-reference-light.png

@@ -20,7 +20,7 @@ Fern maintains official API clients for Node.js and Python. We recommend using t
 
 <Cards>
   <Card
-    title="Node/Typescript"
+    title="Node/TypeScript"
     icon="brands node"
     href="https://github.com/fern-api/node-sdk"
   />