+1 I like this idea. We should not commit generated content to the code git repo
Enrico Il giorno gio 30 giu 2022 alle ore 06:59 Michael Marshall <mmarsh...@apache.org> ha scritto: > > 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
