@devries-cameron20 / composio-1 / commits / e095aaf7f
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: improve PR descriptions in docs automation workflows

Add structured summaries and what-changed sections to auto-generated PRs from docs-update-data and generate-sdk-docs workflows. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmitha Mallesh committed Mar 13, 2026 at 17:34 UTC e095aaf7f26f73f3db80e928c1b5e09cabc69c16
2 files changed +20 -15
.github/workflows/docs-update-data.yml
+8 -11
@@ -71,19 +71,16 @@ jobs:
71 uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725 # v8.0.0
72 with:
73 commit-message: 'docs: update toolkits and API data'
74 - title: 'docs: Update toolkits and API data'
74 + title: 'docs: update toolkits, API spec, and meta tools data'
75 body: |
76 - Auto-generated update from Apollo production deployment.
76 + ## Summary
77 + Automated sync of backend data into the docs site. Triggered by: `${{ github.event_name }}`${{ github.event_name == 'repository_dispatch' && format(' (Hermes commit: {0})', github.event.client_payload.hermes_commit) || '' }}.
78
78 - This PR updates:
79 - - `docs/public/data/toolkits.json` - Full toolkit data
80 - - `docs/public/data/toolkits-list.json` - Light toolkit list
81 - - `docs/public/openapi.json` - OpenAPI specification
82 - - `docs/content/reference/api-reference/*.mdx` - API index pages
83 - - `docs/public/data/meta-tools.json` - Meta tools schemas
84 - - `docs/content/reference/meta-tools/*.mdx` - Meta tools reference pages
85 -
86 - ${{ github.event_name == 'repository_dispatch' && format('Hermes commit: {0}', github.event.client_payload.hermes_commit) || '' }}
79 + ## What changed
80 + - **Toolkit catalog** (`docs/public/data/toolkits.json`, `toolkits-list.json`) — refreshed list of available toolkits, auth schemes, and tools from the backend API
81 + - **OpenAPI spec** (`docs/public/openapi.json`) — latest API specification fetched from production
82 + - **API reference pages** (`docs/content/reference/api-reference/*.mdx`) — regenerated index pages from the updated OpenAPI spec
83 + - **Meta tools reference** (`docs/public/data/meta-tools.json`, `docs/content/reference/meta-tools/*.mdx`) — updated meta tool schemas and reference docs
84 branch: docs/auto-update-data
85 base: next
86 add-paths: |
.github/workflows/generate-sdk-docs.yml
+12 -4
@@ -30,8 +30,12 @@ jobs:
30 uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725 # v8.0.0
31 with:
32 commit-message: 'docs: auto-generate TypeScript SDK reference'
33 - title: 'docs: Update TypeScript SDK reference'
34 - body: Auto-generated TypeScript SDK docs.
33 + title: 'docs: update TypeScript SDK reference from source'
34 + body: |
35 + ## Summary
36 + Auto-generated TypeScript SDK reference docs from `ts/packages/core/src/`.
37 +
38 + Regenerates pages at `docs/content/reference/sdk-reference/typescript/` to reflect changes in the core package's public API (new methods, updated signatures, changed types).
39 branch: docs/auto-update-ts-sdk-reference
40 base: next
41 add-paths: docs/content/reference/sdk-reference/typescript/
@@ -55,8 +59,12 @@ jobs:
59 uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725 # v8.0.0
60 with:
61 commit-message: 'docs: auto-generate Python SDK reference'
58 - title: 'docs: Update Python SDK reference'
59 - body: Auto-generated Python SDK docs.
62 + title: 'docs: update Python SDK reference from source'
63 + body: |
64 + ## Summary
65 + Auto-generated Python SDK reference docs from `python/composio/`.
66 +
67 + Regenerates pages at `docs/content/reference/sdk-reference/python/` to reflect changes in the Python package's public API (new methods, updated signatures, changed types).
68 branch: docs/auto-update-python-sdk-reference
69 base: next
70 add-paths: docs/content/reference/sdk-reference/python/