How might the planned move of various components and adaptors out of the main repository impact the choice to have the docs in the main repository?
> On Nov 17, 2021, at 12:25 PM, Matteo Merli <matteo.me...@gmail.com> wrote: > > I agree with that. > > I understand that there are tradeoffs for each approach, though the > original intention was to allow for doc changes to be committed in the > same PR as the code change. That doesn't have to be the case always, > especially for larger multi-PR changes, but it makes it easier to do > quick corrections to the docs. > > I think the bigger problem here is to get rid of the generated site > HTML stuff from the main pulsar repo. > > -- > Matteo Merli > <matteo.me...@gmail.com> > > On Wed, Nov 17, 2021 at 12:16 PM Enrico Olivelli <eolive...@gmail.com> wrote: >> >> Dave, >> Having a new repo will make it harder for developers to contribute >> documentation. >> >> Usually engineers do it like and do not have time to write docs. >> >> If we ask them to create two PRs only to add, for instance, a new >> configuration option, then it would be somehow a pain. >> >> I am not saying that we shouldn't go this way, but it would be kind of a >> pain for someone and we need to ear more voices. >> >> Enrico >> >> Il Mer 17 Nov 2021, 19:28 Sijie Guo <guosi...@gmail.com> ha scritto: >> >>> I think we should have a PIP for this. Because this impacts all the >>> developers who are making documentation changes. >>> >>> - Sijie >>> >>> On Tue, Nov 16, 2021 at 8:46 AM Dave Fisher <w...@apache.org> wrote: >>> >>>> Hi - >>>> >>>> There are two efforts happening in the community around website refresh. >>>> >>>> (1) Docusaurus upgrades. >>>> (2) New web design. >>>> >>>> There is an effort to eliminate all the extra commits in the asf-site >>>> branch of the main repository. In that thread I proposed a new repository >>>> for the website. >>>> >>>> We can then discuss migration and development both on this mailing list >>>> and as PRs and Issues in that repository. >>>> >>>> Do we want to have a PIP process here or can we be less formal? I think >>>> that PRs. Issues, and simple commits can be sufficient. >>>> >>>> Unless there are objections I will create a new repository - pulsar-site >>>> on Friday in 72 hours. >>>> ‘ >>>> Regards, >>>> Dave >>>> >>>> >>>
