jason810496 commented on PR #70812: URL: https://github.com/apache/airflow/pull/70812#issuecomment-5213350577
> Does TypeScript/JavaScript/Node not have its native tooling for this? I’m not thrilled with using sphinx-js (particularly with it pinning cattrs, but also that there’s one more moving block). Java SDK does not tie its API docs into Sphinx. > > If we’re committed to using sphinx-js, I think this still misses some mechanisms to correctly hook into CI build and publish jobs. I use sphinx-js in the first place as I prefer to able to navigate back to the airflow core site from the user point of view. However, if we considering whether it's able to bump the native TypeDoc framwork itself, then I think we should use just TypeDoc itself. (It shouldn't be difficult to add a tab on the navbar to navigate back to the core docs site). -- 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]
