Merge pull request #451 from hey-api/docs/integrations

docs: add github action to integrations

.changeset/fluffy-ways-sleep.md

@@ -0,0 +1,5 @@
+---
+"openapi-ts-docs": patch
+---
+
+docs: add github action to integrations

docs/openapi-ts/integrations.md

@@ -5,17 +5,35 @@ description: Automate your client generation.
 
 # Integrations <span class="soon">Soon</span>
 
-Integrations allow you to automate your client generation workflow. We suggest using them with `openapi-ts`, but you can use any codegen.
+Integrations allow you to automate your client generation workflow. Create dependency links between your clients and APIs, and watch the magic unfold. While we prefer to use `openapi-ts` for generating clients, you can use any codegen.
 
-<br/>
+## Upload OpenAPI Spec
 
-::: tip
-Integrations are in beta. If you'd like to be one of the first users, [send us an email](mailto:lmenus@lmen.us).
-:::
+First, you need to configure your API services to send us OpenAPI specifications. This can be done by adding our [hey-api/upload-openapi-spec](https://github.com/marketplace/actions/upload-openapi-spec-by-hey-api) GitHub Action into your CI workflow.
 
-## Upload OpenAPI Spec
+```yaml
+name: Upload OpenAPI Specification
 
-More information will be provided as we finalize the tooling.
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  upload-openapi-spec:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Upload OpenAPI spec
+        uses: hey-api/upload-openapi-spec@v1
+        with:
+          hey-api-token: ${{ secrets.HEY_API_TOKEN }}
+          path-to-openapi: path/to/openapi.json
+```
+
+This step requires you to register with us in order to obtain a Hey API token. Please follow the instructions in our [GitHub Action](https://github.com/marketplace/actions/upload-openapi-spec-by-hey-api) to complete the setup. Once you have your APIs configured, you're ready to connect your clients.
 
 ## Configure Clients