Hi All,

It looks like this PR attracted somewhat different opinions in terms of
what is a significant change, what is not and when to wait. Let's discuss
this on this thread before revisioning the PR.

>From my POV, having strict rules is not practical at this stage of the
project because:

* API/SPI is not well-defined
* The codebase evolves quickly, so it is hard to predict downstream ripple
effects.
* Contributor interests are not equally distributed across the codebase

I'd propose a common sense approach where the author and reviewers assess
the impact to the best of their knowledge and then decide:

1) If the change is small and relatively isolated, the change can be merged
immediately.
2) If the change can reasonably be expected to have non-trivial effects in
runtime or in downstream projects, wait 3 working days for other reviewers
to start discussions if necessary.
3) REST API changes are to be discussed on `dev` in all cases.
4) If a concern is missed during review, let's fix forward on `main`. We'll
learn from this and take it into account in subsequent reviews (common
sense).

As the project matures and java API/SPI modules are more formally defined,
we can add more specific guidelines for them.

WDYT?

Thanks,
Dmitri.

On Mon, Nov 17, 2025 at 10:05 AM Dmitri Bourlatchkov <[email protected]>
wrote:

> Hi All,
>
> I opened PR [3067] proposing a bit of clarification and more review time
> for more intrusive PRs. Please refer to GH for the example language.
>
> Please comment about grammar / spelling in GH, but if you have comments
> about the subject matter, it might be best to use this email thread for
> discussing those.
>
> [3067] https://github.com/apache/polaris/pull/3067
>
> Thanks,
> Dmitri.
>

Reply via email to