fix: added redirects in docs.yml (#1244)

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

Author: 3 people

fern/docs.yml

@@ -638,12 +638,12 @@ redirects:
   - source: /learn/fern-definition/:slug*
     destination: /learn/api-definitions/ferndef/:slug*
     permanent: true
-  
+
   # Redirect old others.mdx extension pages to overview pages
   - source: /learn/api-definitions/openapi/extensions/others
     destination: /learn/api-definitions/openapi/extensions/overview
     permanent: true
-  - source: /learn/api-definitions/asyncapi/extensions/others  
+  - source: /learn/api-definitions/asyncapi/extensions/others
     destination: /learn/api-definitions/asyncapi/extensions/overview
     permanent: true
   - source: /learn/api-definitions/openrpc/extensions/others
@@ -652,3 +652,162 @@ redirects:
   - source: /learn/api-definitions/grpc/extensions/:slug*
     destination: /learn/api-definitions/overview/overrides#definition-specific-extensions
     permanent: true
+
+  # ============================================================================
+  # ADDITIONAL /LEARN/* REDIRECTS FROM CRAWLED URLS FROM GOOGLE SEARCH CONSOLE
+  # ============================================================================
+
+  # SDK specific redirects
+  - source: /learn/sdks/generators/java/publishing-to-maven-central
+    destination: /learn/sdks/generators/java/publishing
+    permanent: true
+  - source: /learn/sdks/generators/php/publishing-to-packagist
+    destination: /learn/sdks/generators/php/publishing
+    permanent: true
+  - source: /learn/sdks/generators/python/publishing-to-py-pi
+    destination: /learn/sdks/generators/python/publishing
+    permanent: true
+  - source: /learn/sdks/generators/typescript/publishing-to-npm
+    destination: /learn/sdks/generators/typescript/publishing
+    permanent: true
+  - source: /learn/sdks/generators/java/adding-custom-code
+    destination: /learn/sdks/generators/java/custom-code
+    permanent: true
+  - source: /learn/sdks/reference/configuration
+    destination: /learn/sdks/reference/generators-yml
+    permanent: true
+  - source: /learn/sdks/client
+    destination: /learn/sdks/overview/introduction
+    permanent: true
+  - source: /learn/sdks/src
+    destination: /learn/sdks/overview/project-structure
+    permanent: true
+  - source: /learn/sdks/alternatives/speakeasy
+    destination: /learn/sdks/overview/introduction
+    permanent: true
+
+  # Docs specific redirects
+  - source: /learn/docs/customization/project-structure
+    destination: /learn/docs/getting-started/project-structure
+    permanent: true
+  - source: /learn/docs/alternatives/mintlify
+    destination: /learn/docs/getting-started/overview
+    permanent: true
+  - source: /learn/docs/api-references/api-explorer/advanced-configuration
+    destination: /learn/docs/api-references/api-explorer/overview
+    permanent: true
+  - source: /learn/docs/enterprise/self-hosted
+    destination: /learn/docs/self-hosted/overview
+    permanent: true
+  - source: /learn/docs/content/visual-editor-beta
+    destination: /learn/docs/writing-content/fern-editor
+    permanent: true
+  - source: /learn/docs/content/visual-editor
+    destination: /learn/docs/writing-content/fern-editor
+    permanent: true
+  - source: /learn/docs/content
+    destination: /learn/docs/writing-content/markdown
+    permanent: true
+  - source: /learn/docs/config/overview
+    destination: /learn/docs/configuration/what-is-docs-yml
+    permanent: true
+  - source: /learn/docs/llms.txt8
+    destination: /learn/docs/seo/llms-txt
+    permanent: true
+  - source: /learn/docs/path/to/asset.pdf
+    destination: /learn/docs/getting-started/overview
+    permanent: true
+  - source: /learn/docs/components/tabs
+    destination: /learn/docs/writing-content/components/tabs
+    permanent: true
+  - source: /learn/docs/components/CustomCard
+    destination: /learn/docs/writing-content/custom-react-components
+    permanent: true
+
+  # API Definition redirects
+  - source: /learn/api-definition/openapi/webhooks
+    destination: /learn/api-definitions/openapi/endpoints/webhooks
+    permanent: true
+  - source: /learn/api-definition/introduction
+    destination: /learn/api-definitions/overview/what-is-an-api-definition
+    permanent: true
+  - source: /learn/api-definition/openapi/streaming-and-sse
+    destination: /learn/api-definitions/openapi/endpoints/streaming-and-sse
+    permanent: true
+  - source: /learn/api-definition/openapi/audiences
+    destination: /learn/api-definitions/openapi/audiences
+    permanent: true
+  - source: /learn/api-definition/openapi/examples
+    destination: /learn/api-definitions/openapi/examples
+    permanent: true
+  - source: /learn/api-definition/fern/comparison-with-open-api
+    destination: /learn/api-definitions/ferndef/overview
+    permanent: true
+  - source: /learn/api-definitions/openapi/openapi.yml
+    destination: /learn/api-definitions/openapi/overview
+    permanent: true
+  - source: /learn/api-definitions/ferndef/web-sockets
+    destination: /learn/api-definitions/ferndef/websockets
+    permanent: true
+  - source: /learn/api-definitions/grpc/extensions/server-name
+    destination: /learn/api-definitions/grpc/servers
+    permanent: true
+  - source: /learn/api-definitions/grpc/extensions/timeout
+    destination: /learn/api-definitions/grpc/overview
+    permanent: true
+  - source: /learn/api-definitions/asyncapi/extensions/server-name
+    destination: /learn/api-definitions/asyncapi/extensions/server-names
+    permanent: true
+  - source: /learn/api-definitions/openrpc/extensions/sdk-group-name
+    destination: /learn/api-definitions/openrpc/extensions/sdk-group-names
+    permanent: true
+  - source: /learn/api-definitions/openrpc/extensions/examples
+    destination: /learn/api-definitions/openrpc/examples
+    permanent: true
+  - source: /learn/api-definitions/openrpc/extensions/retry
+    destination: /learn/api-definitions/openrpc/extensions/retry-behavior
+    permanent: true
+  - source: /learn/overview/define-your-api/openapi/extensions
+    destination: /learn/api-definitions/openapi/extensions/overview
+    permanent: true
+
+  # CLI & API Reference redirects
+  - source: /learn/cli-api/cli-reference
+    destination: /learn/cli-api-reference/cli-reference/overview
+    permanent: true
+  - source: /learn/cli-api/api-reference/tokens/generate
+    destination: /learn/cli-api-reference/api-reference/tokens/generate
+    permanent: true
+  - source: /learn/cli-api/api-reference/tokens
+    destination: /learn/cli-api-reference/api-reference/tokens/generate
+    permanent: true
+  - source: /learn/cli-api/api-reference/overview
+    destination: /learn/cli-api-reference/api-reference/overview
+    permanent: true
+  - source: /learn/api/api-reference/docs/generate
+    destination: /learn/cli-api-reference/api-reference/overview
+    permanent: true
+  - source: /learn/api-reference/sdk/generate/~explorer
+    destination: /learn/cli-api-reference/api-reference/sdk/generate
+    permanent: true
+
+  # Ask Fern redirects
+  - source: /learn/ask-fern/features/custom-fa-qs
+    destination: /learn/ask-fern/features/citations
+    permanent: true
+  - source: /learn/ai-search/getting-started/ai-search-customer-showcase
+    destination: https://buildwithfern.com/showcase#ask-fern-customers
+    permanent: true
+
+  # V2 legacy paths (old version of docs)
+  - source: /learn/v2/:slug*
+    destination: /learn/:slug*
+    permanent: true
+
+  # Misc legacy learn paths
+  - source: /learn/snippets/example.ts
+    destination: /learn/cli-api-reference/api-reference/snippets/load
+    permanent: true
+  - source: /learn/cli-reference/path/to/file.pdf
+    destination: /learn/cli-api-reference/cli-reference/overview
+    permanent: true

fern/products/api-def/openapi-pages/examples.mdx

@@ -25,6 +25,8 @@ navigation:
         path: ./pages/features/insights.mdx
       - page: Evaluation
         path: ./pages/features/evals.mdx
+      - page: Role-based access control
+        path: ./pages/features/rbac.mdx
       - page: Slack app
         path: ./pages/features/slack-app.mdx
   - api: API reference