fix: added api-definitions product (#426)

Co-authored-by: Kapil Gowru <[email protected]>
Co-authored-by: Devin Logan <[email protected]>

Author: 3 people

fern/assets/styles.css

@@ -181,75 +181,53 @@ h1, h2, h3 {
       }
     }
 
-    > a[href*="fern-def"] {
+    > a[href*="asyncapi"] {
       grid-column: 3;
       grid-row: 2;
       transform: translateY(-32px);
-      
+
       .fern-selection-item-icon {
         width: 1.5rem;
         height: 1.5rem;
       }
     }
 
-    /* > a[href*="asyncapi"]:before {
-      content: "Docs coming soon";
-      font-weight: 500;
-      position: absolute;
-      top: -1.75rem;
-      left: 0.5rem;
-    } */
-   
-    > a[href*="asyncapi"] {
+    > a[href*="openrpc"] {
       grid-column: 3;
       grid-row: 3;
       transform: translateY(-64px);
-      pointer-events: none;
-      cursor: not-allowed;
-
-      /* > div > div > div {
-        align-items: flex-start;
-      } */
 
       .fern-selection-item-icon {
         width: 1.5rem;
         height: 1.5rem;
       }
     }
 
-    > a[href*="openrpc"] {
+    > a[href*="grpc"] {
       grid-column: 3;
       grid-row: 4;
-      transform: translateY(-88px);
-      pointer-events: none;
-      cursor: not-allowed;
-
-      /* > div > div > div {
-        align-items: flex-start;
-      } */
+      transform: translateY(-96px);
 
       .fern-selection-item-icon {
         width: 1.5rem;
         height: 1.5rem;
       }
     }
 
-    > a[href*="grpc"] {
+    > a[href*="fern-def"] {
       grid-column: 3;
       grid-row: 5;
-      transform: translateY(-88px);
-      pointer-events: none;
-      cursor: not-allowed;
-
-      /* > div > div > div {
-        align-items: flex-start;
-      } */
+      transform: translateY(-96px);
 
       .fern-selection-item-icon {
         width: 1.5rem;
         height: 1.5rem;
       }
     }
+
+    > a[href*="api-definitions"] {
+      display: none;
+    }
   }
 }
 

fern/docs.yml

@@ -1,5 +1,5 @@
 instances:
-  - url: fern-v2.docs.buildwithfern.com/learn/v2
+  - url: fern-v2.docs.buildwithfern.com/learn
   - url: fern.docs.buildwithfern.com/learn
     custom-domain: buildwithfern.com/learn
     edit-this-page:
@@ -43,46 +43,48 @@ products:
     slug: ask-fern
     subtitle: Let users find answers in your documentation instantly
 
-  - display-name: OpenAPI
-    path: ./products/openapi-def/openapi-def.yml
-    icon: fa-regular fa-book
-    image: ./images/product-switcher/openapi-definition-light.png
-    slug: openapi-definition
-  
-  - display-name: Fern Definition
-    path: ./products/fern-def/fern-def.yml
-    icon: fa-regular fa-seedling
-    image: ./images/product-switcher/fern-definition-light.png
-    slug: fern-definition
-
   - display-name: CLI & API Reference
-    subtitle: Manage and configure your Fern projects via CLI & APIs.
+    subtitle: Manage and configure your Fern projects
     path: ./products/cli-api-reference/cli-api-reference.yml
     icon: fa-regular fa-terminal
     image: ./images/product-switcher/product-switcher-cliapi-light.png
     slug: cli-api-reference
 
+  - display-name: API Definitions
+    path: ./products/api-def/api-def.yml
+    icon: fa-regular fa-book
+    image: ./images/product-switcher/openapi-definition-light.png
+    slug: api-definitions
+
+  - display-name: OpenAPI
+    path: ./products/api-def/api-def.yml
+    icon: fa-regular fa-book
+    image: ./images/product-switcher/openapi-definition-light.png
+    slug: openapi-definition
+  
   - display-name: AsyncAPI
-    subtitle: Docs coming soon
-    path: ./products/asyncapi-def/asyncapi-def.yml
+    path: ./products/api-def/api-def.yml
     icon: fa-regular fa-bolt
     image: ./images/product-switcher/asyncapi-light.png
     slug: asyncapi-definition
-  
+
   - display-name: OpenRPC
-    subtitle: Docs coming soon
-    path: ./products/openrpc-def/openrpc-def.yml
+    path: ./products/api-def/api-def.yml
     icon: fa-regular fa-code
     image: ./images/product-switcher/openrpc-light.png
     slug: openrpc-definition
 
   - display-name: gRPC
-    subtitle: Docs coming soon
-    path: ./products/grpc-def/grpc-def.yml
+    path: ./products/api-def/api-def.yml
     icon: fa-regular fa-plug
     image: ./images/product-switcher/grpc-light.png
     slug: grpc-definition
 
+  - display-name: Fern Definition
+    path: ./products/api-def/api-def.yml
+    icon: fa-regular fa-seedling
+    image: ./images/product-switcher/fern-definition-light.png
+    slug: fern-definition
 
 css: ./assets/styles.css
 
@@ -190,7 +192,7 @@ redirects:
     destination: /learn/sdks/deep-dives/local-previews
     permanent: true
   - source: /learn/sdks/capabilities/auto-pagination
-    destination: /learn/v2/sdks/deep-dives/auto-pagination
+    destination: /learn/sdks/deep-dives/auto-pagination
     permanent: true
   - source: /learn/sdks/capabilities/idempotency-headers
     destination: /learn/sdks/deep-dives/idempotency
@@ -336,12 +338,21 @@ redirects:
   - source: /learn/docs/building-and-customizing-your-docs/navigation
     destination: /learn/docs/navigation/overview
     permanent: true
+  - source: /learn/docs/navigation/overview
+    destination: /learn/docs/configuration/navigation
+    permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/versioning
     destination: /learn/docs/navigation/versions
     permanent: true
+  - source: /learn/docs/navigation/versions
+    destination: /learn/docs/configuration/versions
+    permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/announcements
     destination: /learn/docs/navigation/announcement-banner
     permanent: true
+  - source: /learn/docs/navigation/announcement-banner
+    destination: /learn/docs/customization/announcement-banner
+    permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/links-and-redirects
     destination: /learn/docs/seo/redirects
     permanent: true
@@ -351,12 +362,18 @@ redirects:
   - source: /learn/docs/building-and-customizing-your-docs/hiding-content
     destination: /learn/docs/navigation/hiding-content
     permanent: true
+  - source: /learn/docs/navigation/hiding-content
+    destination: /learn/docs/customization/hiding-content
+    permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/pull-request-preview
     destination: /learn/docs/preview-publish/previewing-changes-in-a-pr
     permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/product-switching
     destination: /learn/docs/navigation/products
     permanent: true
+  - source: /learn/docs/navigation/products
+    destination: /learn/docs/configuration/products
+    permanent: true
   - source: /learn/docs/building-and-customizing-your-docs/custom-css-global-js
     destination: /learn/docs/customization/custom-css-js
     permanent: true
@@ -388,6 +405,9 @@ redirects:
   - source: /learn/docs/content/changelog
     destination: /learn/docs/navigation/changelogs
     permanent: true
+  - source: /learn/docs/navigation/changelogs
+    destination: /learn/docs/customization/changelogs
+    permanent: true
   - source: /learn/docs/content/visual-editor
     destination: /learn/docs/writing-content/visual-editor
     permanent: true
@@ -550,3 +570,21 @@ redirects:
     destination: /learn/cli-api-reference/api-reference/tokens/:slug*
     permanent: true
 
+  # ============================================================================
+  # API REFERENCE REDIRECTS
+  # ============================================================================
+  - source: /learn/openapi-definition/:slug*
+    destination: /learn/api-definitions/openapi/:slug*
+    permanent: true
+  - source: /learn/asyncapi-definition/:slug*
+    destination: /learn/api-definitions/asyncapi/:slug*
+    permanent: true
+  - source: /learn/openrpc-definition/:slug*
+    destination: /learn/api-definitions/openrpc/:slug*
+    permanent: true
+  - source: /learn/grpc-definition/:slug*
+    destination: /learn/api-definitions/grpc/:slug*
+    permanent: true
+  - source: /learn/fern-definition/:slug*
+    destination: /learn/api-definitions/ferndef/:slug*
+    permanent: true