jason810496 opened a new pull request, #71833: URL: https://github.com/apache/airflow/pull/71833
- **Depends on https://github.com/apache/airflow/pull/71822 get merged first** (only the last commit is new here). - **Diff for early review**: https://github.com/jason810496/airflow/compare/feature/ts-sdk/1-0-0-beta1...docs/ts-sdk/categorize-api-reference ## Why The TypeScript SDK API reference currently mixes user-facing Dag authoring symbols with supporting and runtime details. The language SDK guide also needs to reflect the beta's Dag-based syntax. ## What - Group the generated API reference into Authoring, Types, Exceptions, and Internals sections using docs-only TypeDoc entry points. - Keep coordinator startup APIs out of the public reference and place only `SUPERVISOR_API_VERSION` under Internals. - Preserve exception links across the new documentation sections. - Align the TypeScript language SDK guide with `Dag`, `DagRegistry`, and `serveDags`. - Trigger the TypeDoc CI build when a documentation category entry point changes. ## Verification <img width="1506" height="828" alt="Screenshot 2026-08-19 at 6 46 32 PM" src="https://github.com/user-attachments/assets/74d1e7dd-1c85-4ce2-9dbe-f0b24d0fb3f3"; /> --- ##### Was generative AI tooling used to co-author this PR? - [x] Yes, with help of Codex GPT-5 following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
