tisonkun opened a new issue, #18014: URL: https://github.com/apache/pulsar/issues/18014
### Search before asking - [X] I searched in the [issues](https://github.com/apache/pulsar/issues) and found nothing similar. ### What issue do you find in Pulsar docs? Currently, we build swagger files and config references on the site build stage. It prevents developers to preview the website smoothly. ### What is your suggestion? I suggest we generate swagger files and config references during the sync stage and put generated files under `static` folder relate to the root path of docusaurus framework. So that we can properly preview the website fully. ### Any reference? Related files: * site2/tools/build-site.sh * site2/tools/docker-build-site.sh * site2/tools/pulsar-admin-doc-gen.sh * site2/tools/pulsar-client-doc-gen.sh * site2/tools/pulsar-perf-doc-gen.sh * site2/tools/pulsar-doc-gen.sh * site2/tools/pulsar-config-doc-gen.sh * site2/website-next/scripts/split-swagger-by-version.js * .github/workflows/ci-pulsar-website-docs-sync.yaml * .github/workflows/ci-pulsar-website-next-build.yaml cc @urfreespace @michaeljmarshall @Anonymitaet @SignorMercurio ### Are you willing to submit a PR? - [ ] I'm willing to submit a PR! -- 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]
