Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 22, 03:15 UTC
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/