Merge branch 'main' into devin/1761268929-document-accordion-defaultopen

Author: devalog

.github/workflows/auto-merge-on-docs-release.yml

@@ -0,0 +1,50 @@
+# .github/workflows/auto-merge-on-release.yml in docs repo
+name: Auto-merge on Docs Release
+on:
+  repository_dispatch:
+    types: [docs_release]
+
+jobs:
+  merge-dependent-prs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Find and merge dependent PRs
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const version = context.payload.client_payload.version;
+            
+            // Find PRs with matching labels
+            const { data: prs } = await github.rest.pulls.list({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open'
+            });
+            
+            for (const pr of prs) {
+              const labels = pr.labels.map(l => l.name);
+              const hasLatestLabel = labels.includes('depends-on: docs@latest');
+              const hasVersionLabel = labels.includes(`depends-on: docs@${version}`);
+              
+              if (hasLatestLabel || hasVersionLabel) {
+                // Check if PR is approved and CI passes
+                const { data: reviews } = await github.rest.pulls.listReviews({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  pull_number: pr.number
+                });
+                
+                const approved = reviews.some(r => r.state === 'APPROVED');
+                
+                if (approved) {
+                  await github.rest.pulls.merge({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    pull_number: pr.number,
+                    merge_method: 'squash'
+                  });
+                  
+                  console.log(`Merged PR #${pr.number}: ${pr.title}`);
+                }
+              }
+            }

.vale/styles/FernStyles/Headings.yml

@@ -80,3 +80,32 @@ exceptions:
   - CSS
   - HTML
   - JSON
+  - OpenAPI
+  - AsyncAPI
+  - Fern Definition
+  - WebSockets
+  - MQTT
+  - JSON-RPC
+  - Protocol Buffers
+  - TLS
+  - JWT
+  - OAuth2
+  - API
+  - CircleCI
+  - GitLab CI
+  - CI/CD
+  - Kubernetes
+  - Buf
+  - FastAPI
+  - PyPI
+  - Maven
+  - Spring Boot
+  - Pydantic
+  - Postman
+  - HTTP
+  - HTTPS
+  - TCP
+  - Protobuf
+  - Proto
+  - RBAC
+  - YAML

fern/products/api-def/asyncapi-pages/auth.mdx

@@ -59,7 +59,7 @@ components:
         env: AUTH_TOKEN
 ```
 
-## API Key security scheme
+## API key security scheme
 
 Start by defining an `apiKey` security scheme in your `asyncapi.yml`: 
 
@@ -81,7 +81,7 @@ const client = new Client({
 })
 ```
 
-### Custom API Key variable name
+### Custom API key variable name
 
 If you want to control variable naming and the environment variable to scan, 
 use the configuration below:
@@ -120,7 +120,7 @@ const client = new Client({
 })
 ```
 
-### Custom Basic Auth variable names
+### Custom basic auth variable names
 
 If you want to control variable naming and the environment variables to scan, 
 use the configuration below:

fern/products/api-def/asyncapi-pages/automation.mdx

@@ -1,5 +1,5 @@
 ---
-title: Sync your AsyncAPI Specification
+title: Sync your AsyncAPI specification
 subtitle: Automatically sync your AsyncAPI spec changes to keep SDKs and docs up to date
 ---
 
@@ -85,7 +85,7 @@ api:
       version: 0.8.8
 ```
 
-### From Git repository
+### From git repository
 ```yaml title="generators.yml" {3-7}
 api:
   specs:
@@ -200,4 +200,4 @@ api:
       version: 0.8.8
 ```
 
-This ensures that any breaking changes to your AsyncAPI specification are detected and the appropriate team members are notified before the changes are propagated to your SDKs and documentation. 
+This ensures that any breaking changes to your AsyncAPI specification are detected and the appropriate team members are notified before the changes are propagated to your SDKs and documentation.  

fern/products/api-def/asyncapi-pages/extensions/parameter-names.mdx

@@ -1,5 +1,5 @@
 ---
-title: Parameter Names
+title: Parameter names
 subtitle: Use `x-fern-parameter-name` to customize SDK parameter names for message properties
 ---
 
@@ -76,4 +76,4 @@ channels:
           type: string
 ```
 
-This ensures consistent naming conventions across your SDK while maintaining compatibility with your existing message formats. 
+This ensures consistent naming conventions across your SDK while maintaining compatibility with your existing message formats.  

fern/products/api-def/asyncapi-pages/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: What is an AsyncAPI Specification?
+title: What is an AsyncAPI specification?
 description: AsyncAPI is a standard for documenting event-driven APIs
 ---
 
@@ -174,4 +174,4 @@ fern/
     └─ asyncapi.yml
 ```
 </Step>
-</Steps>
+</Steps>

fern/products/api-def/ferndef-pages/api-yml/global-configuration.mdx

@@ -1,5 +1,5 @@
 ---
-title: Global Configuration
+title: Global configuration
 description: Specify global headers, path parameters or query parameters meant to be included on every request.
 ---
 
@@ -52,4 +52,4 @@ service:
 ## Global query parameters
 
 You cannot yet specify query parameters that are meant to be included on every request.
-If you'd like to see this feature, please upvote [this issue](https://github.com/fern-api/fern/issues/2930).
+If you'd like to see this feature, please upvote [this issue](https://github.com/fern-api/fern/issues/2930).

fern/products/api-def/ferndef-pages/endpoints/bytes.mdx

@@ -1,5 +1,5 @@
 ---
-title: Binary Data and Files
+title: Binary data and files
 subtitle: Use the `bytes` type to handle binary data in your API
 ---
 

fern/products/api-def/ferndef-pages/endpoints/multipart.mdx

@@ -1,5 +1,5 @@
 ---
-title: Multipart File Upload
+title: Multipart file upload
 description: Document endpoints with the `multiform` content type.
 ---
 
@@ -24,7 +24,7 @@ service:
 
 Within a given multipart request, a string parameter with `format:binary` will represent an arbitrary file.
 
-## List of Files
+## List of files
 
 If your endpoint supports a list of files, then your request body must indicate such.
 

fern/products/api-def/ferndef-pages/endpoints/sse.mdx

@@ -1,5 +1,5 @@
 ---
-title: Server-Sent Events and Streaming APIs
+title: Server-sent events and streaming APIs
 subtitle: Use the `response-stream` key to model streaming endpoints
 ---
 
@@ -97,4 +97,4 @@ types:
   ChatChunk:
     properties:
       text: string
-```
+```