Hi Pulsar Community, I would like to discuss changing where our generated docs are stored.
Currently, we keep some generated docs, like the python client docs and the swagger docs, in our apache/pulsar repo. There are other docs that are generated and stored in our apache/pulsar-site repo. I propose that we move all generated docs to be stored in the apache/pulsar-site repo. This change will primarily affect release managers since they will need to push commits to the pulsar-site repo. No one else should need to modify generated docs. My primary motivation is that I'd like to add new generated Javadoc pages for all of our recent releases so that we no longer only serve "-SNAPSHOT" versions of the generated docs. Those new docs will increase the size of our apache/pulsar repo. I prefer to keep the apache/pulsar repo small. I plan to open a PR to move these docs from the apache/pulsar repo to the apache/pulsar-site repo later this week or early next week, unless anyone has strong objections. I'll also update our release manager documentation for the new process. Thanks, Michael
