Correct message should be added to original exception thrown at cache update.
Re-thrown exception case is not counter-example for general approach. чт, 10 мая 2018 г. в 16:24, Anton Vinogradov <a...@apache.org>: > >> U.error(log, "Unexpected exception during cache update", e); > >> I mean, we genuinely don't know what happened here. > Fully agree with Ilya. > In some cases it's impossible to explain the reason. > All we can is just to log the error. > > >> Error text `Unexpected exception during cache update` is brilliant > example > >> how product should not behave. > Dmitry, could you please provide correct message for this case? > > > чт, 10 мая 2018 г. в 16:23, Ilya Kasnacheev <ilya.kasnach...@gmail.com>: > > > Dmitry, > > > > can you please perform an excercise of looking that piece of code up > > > > > (org.apache.ignite.internal.processors.cache.distributed.dht.atomic.GridDhtAtomicCache), > > telling us how an ideal message should look like in this case? > > > > Thanks, > > > > -- > > Ilya Kasnacheev > > > > 2018-05-10 16:15 GMT+03:00 Dmitry Pavlov <dpavlov....@gmail.com>: > > > > > Hi Ilya, > > > > > > Error text `Unexpected exception during cache update` is brilliant > > example > > > how product should not behave. > > > > > > So requiring contributors to explain reasons of failure would be good > > first > > > step to come to situation that exception text is so clear that user > will > > > know what to do. It will defenetely reduce number of messages to user > > list. > > > > > > Sincerely, > > > Dmitriy Pavlov > > > > > > > > > чт, 10 мая 2018 г. в 15:50, Ilya Kasnacheev <ilya.kasnach...@gmail.com > >: > > > > > > > I don't think I quite understand how exception explanations should > > work. > > > > > > > > Imagine we have the following exception: > > > > > > > > // At least RuntimeException can be thrown by the code above when > > > > GridCacheContext is cleaned and there is > > > > // an attempt to use cleaned resources. > > > > U.error(log, "Unexpected exception during cache update", e); > > > > > > > > I mean, we genuinely don't know what happened here. > > > > > > > > Under new rules, what kind of "workaround" would that exception > > suggest? > > > > "Try turning it off and then back on"? > > > > What explanation how to resolve this exception can we offer? "Please > > > write > > > > to d...@apache.ignite.org or to Apache JIRA, and then wait for a > > release > > > > with fix?" > > > > > > > > I'm really confused how we can implement 1.6 and 1.7 when dealing > with > > > > messy real-world code. > > > > > > > > Regards, > > > > > > > > > > > > -- > > > > Ilya Kasnacheev > > > > > > > > 2018-05-10 11:39 GMT+03:00 Vladimir Ozerov <voze...@gridgain.com>: > > > > > > > > > Andrey, Anton, Alex > > > > > > > > > > Agree, *SHOULD* is more appropriate here. > > > > > > > > > > Please see latest version below. Does anyone want to add or change > > > > > something? Let's wait for several days for more feedback and then > > > publish > > > > > and announce this list. Note that it would not be carved in stone > and > > > we > > > > > will be able to change it at any time if needed. > > > > > > > > > > 1) API > > > > > 1.1) API compatibility *MUST* be maintained between minor releases. > > Do > > > > not > > > > > remove existing methods or change their signatures, deprecate them > > > > instead > > > > > 1.2) Default behaviour "SHOULD NOT* be changed between minor > > releases, > > > > > unless absolutely needed. If change is made, it *MUST* be described > > in > > > > > "Migration Guide" > > > > > 1.3) New operation *MUST* be well-documented in code (javadoc, > > > > dotnetdoc): > > > > > documentation must contain method's purpose, description of > > parameters > > > > and > > > > > how their values affect the outcome, description of return value > and > > > it's > > > > > default, behavior in negative cases, interaction with other > > operations > > > > and > > > > > components > > > > > 1.4) API parity between Java and .NET platforms *SHOULD* be > > maintained > > > > when > > > > > operation makes sense on both platforms. If method cannot be > > > implemented > > > > in > > > > > a platform immediately, new JIRA ticket *MUST* be created and > linked > > to > > > > > current ticket > > > > > 1.5) API parity between thin clients (Java, .NET) *SHOULD* be > > > maintained > > > > > when operation makes sense on several clients. If method cannot be > > > > > implemented in a client immediately, new JIRA ticket *MUST* be > > created > > > > and > > > > > linked to current ticket > > > > > 1.6) All exceptions thrown to a user **SHOULD** have explanation > how > > to > > > > > resolve, workaround or debug an error > > > > > > > > > > 2) Compatibility > > > > > 2.1) Persistence backward compatibility *MUST* be maintained > between > > > > minor > > > > > releases. It should be possible to start newer version on data > files > > > > > created by the previous version > > > > > 2.2) Thin client forward and backward compatibility *SHOULD* be > > > > maintained > > > > > between two consecutive minor releases. If compatibility cannot be > > > > > maintained it *MUST* be described in "Migration Guide" > > > > > 2.3) JDBC and ODBC forward and backward compatibility *SHOULD* be > > > > > maintained between two consecutive minor releases. If compatibility > > > > cannot > > > > > be maintained it *MUST* be described in "Migration Guide" > > > > > > > > > > 3) Tests > > > > > 3.1) New functionality *MUST* be covered with unit tests for both > > > > positive > > > > > and negative use cases > > > > > 3.2) All test suites *MUST* be run before merge to master..There > > *MUST* > > > > be > > > > > no new test failures > > > > > > > > > > 4) Code style *MUST* be followed as per Ignite's Coding Guidelines > > > > > > > > > > Vladimir. > > > > > > > > > > > > > > > On Tue, May 8, 2018 at 1:05 PM, Andrey Kuznetsov < > stku...@gmail.com> > > > > > wrote: > > > > > > > > > > > Anton, > > > > > > > > > > > > I agree, *MUST* for exception reasons and *SHOULD* for ways of > > > > resolution > > > > > > sound clearer. > > > > > > > > > > > > 2018-05-08 12:56 GMT+03:00 Anton Vinogradov <a...@apache.org>: > > > > > > > > > > > > > Andrey, > > > > > > > > > > > > > > How about > > > > > > > 1.6) All exceptions thrown to a user *MUST* have explanation of > > > > > > workaround > > > > > > > and contain original error. > > > > > > > All exceptions thrown to a user *SHOULD* have explanation how > to > > > > > resolve > > > > > > if > > > > > > > possible. > > > > > > > ? > > > > > > > > > > > > > > вт, 8 мая 2018 г. в 12:26, Andrey Kuznetsov <stku...@gmail.com > >: > > > > > > > > > > > > > > > Vladimir, checklist looks pleasant enough for me. > > > > > > > > > > > > > > > > I'd like to suggest one minor change. In 1.6 *MUST* seems to > be > > > too > > > > > > > strict, > > > > > > > > *SHOULD* would be enough. It can be frustrating for API user > > if I > > > > > > explain > > > > > > > > how to fix NPEs in a trivial way, for example. > > > > > > > > > > > > > > > > 2018-05-08 11:34 GMT+03:00 Anton Vinogradov <a...@apache.org>: > > > > > > > > > > > > > > > > > Alex, > > > > > > > > > > > > > > > > > > It is not sounds like that, obviously. > > > > > > > > > > > > > > > > > > Tests should cover all negative and positive cases. > > > > > > > > > You should add enough tests to cover all cases. > > > > > > > > > > > > > > > > > > Sometimes one test can cover more than one case, so two > tests > > > > *CAN* > > > > > > > > > partially check same things. > > > > > > > > > In case some cases already covered you should not create > > > > > duplicates. > > > > > > > > > > > > > > > > > > вт, 8 мая 2018 г. в 10:19, Александр Меньшиков < > > > > > sharple...@gmail.com > > > > > > >: > > > > > > > > > > > > > > > > > > > Vladimir, the 3.1 is a bit unclear for me. Which code > > > coverage > > > > is > > > > > > > > > > acceptable? Now it sounds like two tests are enough (one > > for > > > > > > positive > > > > > > > > and > > > > > > > > > > one for negative cases). > > > > > > > > > > > > > > > > > > > > 2018-05-07 23:09 GMT+03:00 Dmitriy Setrakyan < > > > > > > dsetrak...@apache.org > > > > > > > >: > > > > > > > > > > > > > > > > > > > > > Is this list on the Wiki? > > > > > > > > > > > > > > > > > > > > > > On Mon, May 7, 2018 at 7:26 AM, Vladimir Ozerov < > > > > > > > > voze...@gridgain.com> > > > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > > > > > Igniters, > > > > > > > > > > > > > > > > > > > > > > > > This is the checklist I have at the moment. Please > let > > me > > > > > know > > > > > > if > > > > > > > > you > > > > > > > > > > > have > > > > > > > > > > > > any comments on existing items, or want to add or > > remove > > > > > > > anything. > > > > > > > > It > > > > > > > > > > > looks > > > > > > > > > > > > like we may have not only strict rules, but *nice to > > > have* > > > > > > points > > > > > > > > > here > > > > > > > > > > as > > > > > > > > > > > > well with help of *MUST*, *SHOULD* and *MAY* words as > > per > > > > > > RFC2119 > > > > > > > > > [1]. > > > > > > > > > > So > > > > > > > > > > > > please feel free to suggest optional items as well. > > > > > > > > > > > > > > > > > > > > > > > > 1) API > > > > > > > > > > > > 1.1) API compatibility *MUST* be maintained between > > minor > > > > > > > releases. > > > > > > > > > Do > > > > > > > > > > > not > > > > > > > > > > > > remove existing methods or change their signatures, > > > > deprecate > > > > > > > them > > > > > > > > > > > instead > > > > > > > > > > > > 1.2) Default behaviour "SHOULD NOT* be changed > between > > > > minor > > > > > > > > > releases, > > > > > > > > > > > > unless absolutely needed. If change is made, it > *MUST* > > be > > > > > > > described > > > > > > > > > in > > > > > > > > > > > > "Migration Guide" > > > > > > > > > > > > 1.3) New operation *MUST* be well-documented in code > > > > > (javadoc, > > > > > > > > > > > dotnetdoc): > > > > > > > > > > > > documentation must contain method's purpose, > > description > > > of > > > > > > > > > parameters > > > > > > > > > > > and > > > > > > > > > > > > how their values affect the outcome, description of > > > return > > > > > > value > > > > > > > > and > > > > > > > > > > it's > > > > > > > > > > > > default, behavior in negative cases, interaction with > > > other > > > > > > > > > operations > > > > > > > > > > > and > > > > > > > > > > > > components > > > > > > > > > > > > 1.4) API parity between Java and .NET platforms > > *SHOULD* > > > be > > > > > > > > > maintained > > > > > > > > > > > when > > > > > > > > > > > > operation makes sense on both platforms. If method > > cannot > > > > be > > > > > > > > > > implemented > > > > > > > > > > > in > > > > > > > > > > > > a platform immediately, new JIRA ticket *MUST* be > > created > > > > and > > > > > > > > linked > > > > > > > > > to > > > > > > > > > > > > current ticket > > > > > > > > > > > > 1.5) API parity between thin clients (Java, .NET) > > > *SHOULD* > > > > be > > > > > > > > > > maintained > > > > > > > > > > > > when operation makes sense on several clients. If > > method > > > > > cannot > > > > > > > be > > > > > > > > > > > > implemented in a client immediately, new JIRA ticket > > > *MUST* > > > > > be > > > > > > > > > created > > > > > > > > > > > and > > > > > > > > > > > > linked to current ticket > > > > > > > > > > > > 1.6) All exceptions thrown to a user *MUST* have > > > > explanation > > > > > > how > > > > > > > to > > > > > > > > > > > > resolve, workaround or debug an error > > > > > > > > > > > > > > > > > > > > > > > > 2) Compatibility > > > > > > > > > > > > 2.1) Persistence backward compatibility *MUST* be > > > > maintained > > > > > > > > between > > > > > > > > > > > minor > > > > > > > > > > > > releases. It should be possible to start newer > version > > on > > > > > data > > > > > > > > files > > > > > > > > > > > > created by the previous version > > > > > > > > > > > > 2.2) Thin client forward and backward compatibility > > > > *SHOULD* > > > > > be > > > > > > > > > > > maintained > > > > > > > > > > > > between two consecutive minor releases. If > > compatibility > > > > > cannot > > > > > > > be > > > > > > > > > > > > maintained it *MUST* be described in "Migration > Guide" > > > > > > > > > > > > 2.3) JDBC and ODBC forward and backward compatibility > > > > > *SHOULD* > > > > > > be > > > > > > > > > > > > maintained between two consecutive minor releases. If > > > > > > > compatibility > > > > > > > > > > > cannot > > > > > > > > > > > > be maintained it *MUST* be described in "Migration > > Guide" > > > > > > > > > > > > > > > > > > > > > > > > 3) Tests > > > > > > > > > > > > 3.1) New functionality *MUST* be covered with unit > > tests > > > > for > > > > > > both > > > > > > > > > > > positive > > > > > > > > > > > > and negative use cases > > > > > > > > > > > > 3.2) All test suites *MUST* be run before merge to > > > > > > master..There > > > > > > > > > *MUST* > > > > > > > > > > > be > > > > > > > > > > > > no new test failures > > > > > > > > > > > > > > > > > > > > > > > > 4) Code style *MUST* be followed as per Ignite's > Coding > > > > > > > Guidelines > > > > > > > > > > > > > > > > > > > > > > > > Vladimir. > > > > > > > > > > > > > > > > > > > > > > > > [1] https://www.ietf.org/rfc/rfc2119.txt > > > > > > > > > > > > > > > > > > > > > > > > On Fri, May 4, 2018 at 4:33 PM, Vladimir Ozerov < > > > > > > > > > voze...@gridgain.com> > > > > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > > > > > > > Hi Dmitry, > > > > > > > > > > > > > > > > > > > > > > > > > > Yes, I'll do that in the nearest days. > > > > > > > > > > > > > > > > > > > > > > > > > > On Wed, Apr 25, 2018 at 8:24 PM, Dmitry Pavlov < > > > > > > > > > > dpavlov....@gmail.com> > > > > > > > > > > > > > wrote: > > > > > > > > > > > > > > > > > > > > > > > > > >> Igniters, the idea was related to small > refactorings > > > > > > > co-located > > > > > > > > > with > > > > > > > > > > > > main > > > > > > > > > > > > >> change. > > > > > > > > > > > > >> > > > > > > > > > > > > >> Main change itself indicates that existing code > did > > > not > > > > > meet > > > > > > > the > > > > > > > > > > > > criteria > > > > > > > > > > > > >> of practice. Approving of standalone refactorings > > > > instead > > > > > > > > > > contradicts > > > > > > > > > > > > with > > > > > > > > > > > > >> principle don't touch if it works. So I still like > > > idea > > > > of > > > > > > > > > > co-located > > > > > > > > > > > > >> changes improving code, javadocs, style, etc. > > > > > > > > > > > > >> > > > > > > > > > > > > >> But let's not argue about this point now, let's > > > > summarize > > > > > > the > > > > > > > > > > > undisputed > > > > > > > > > > > > >> points and add it to the wiki. Vladimir, would you > > > > please > > > > > do > > > > > > > it? > > > > > > > > > > > > >> > > > > > > > > > > > > >> > > > > > > > > > > > > >> ср, 25 апр. 2018 г. в 16:42, Nikolay Izhikov < > > > > > > > > nizhi...@apache.org > > > > > > > > > >: > > > > > > > > > > > > >> > > > > > > > > > > > > >> > Igniters, > > > > > > > > > > > > >> > > > > > > > > > > > > > >> > I agree with Vova. > > > > > > > > > > > > >> > > > > > > > > > > > > > >> > Don't fix if it works! > > > > > > > > > > > > >> > > > > > > > > > > > > > >> > If you 100% sure then it a useful addition to > the > > > > > product > > > > > > - > > > > > > > > just > > > > > > > > > > > make > > > > > > > > > > > > a > > > > > > > > > > > > >> > separate ticket. > > > > > > > > > > > > >> > > > > > > > > > > > > > >> > В Ср, 25/04/2018 в 11:44 +0300, Vladimir Ozerov > > > пишет: > > > > > > > > > > > > >> > > Guys, > > > > > > > > > > > > >> > > > > > > > > > > > > > > >> > > The problem with in-place refactorings is that > > you > > > > > > > increase > > > > > > > > > > > affected > > > > > > > > > > > > >> > scope. > > > > > > > > > > > > >> > > It is not uncommon to break compatibility or > > > public > > > > > > > > contracts > > > > > > > > > > with > > > > > > > > > > > > >> even > > > > > > > > > > > > >> > > minor things. E.g. recently we decided drop > > > > org.jsr166 > > > > > > > > package > > > > > > > > > > in > > > > > > > > > > > > >> favor > > > > > > > > > > > > >> > of > > > > > > > > > > > > >> > > Java 8 classes. Innocent change. Result - > broken > > > > > > storage. > > > > > > > > > > Another > > > > > > > > > > > > >> problem > > > > > > > > > > > > >> > > is conflicts. It is not uncommon to have > > > long-lived > > > > > > > branches > > > > > > > > > > which > > > > > > > > > > > > we > > > > > > > > > > > > >> > need > > > > > > > > > > > > >> > > to merge with master over and over again. And > a > > > lot > > > > of > > > > > > > > > > > refactorings > > > > > > > > > > > > >> cause > > > > > > > > > > > > >> > > conflicts. It is much easier to resolve them > if > > > you > > > > > know > > > > > > > > that > > > > > > > > > > > logic > > > > > > > > > > > > >> was > > > > > > > > > > > > >> > not > > > > > > > > > > > > >> > > affected as opposed to cases when you need to > > > > resolve > > > > > > both > > > > > > > > > > renames > > > > > > > > > > > > and > > > > > > > > > > > > >> > > method extractions along with business-logic > > > > changes. > > > > > > > > > > > > >> > > > > > > > > > > > > > > >> > > I'd like to repeat - if you have a time for > > > > > refactoring > > > > > > > then > > > > > > > > > you > > > > > > > > > > > > >> > definitely > > > > > > > > > > > > >> > > have a time to extract these changes to > separate > > > PR > > > > > and > > > > > > > > > submit a > > > > > > > > > > > > >> separate > > > > > > > > > > > > >> > > ticket. I am quite understand what "low > > priority" > > > do > > > > > you > > > > > > > > mean > > > > > > > > > if > > > > > > > > > > > you > > > > > > > > > > > > >> do > > > > > > > > > > > > >> > > refactorings on your own. > > > > > > > > > > > > >> > > > > > > > > > > > > > > >> > > On Tue, Apr 24, 2018 at 10:52 PM, Andrey > > > Kuznetsov < > > > > > > > > > > > > stku...@gmail.com > > > > > > > > > > > > >> > > > > > > > > > > > > > >> > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > >> > > > +1. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > Once again, I beg for "small refactoring > > > > permission" > > > > > > in > > > > > > > a > > > > > > > > > > > > checklist. > > > > > > > > > > > > >> > As of > > > > > > > > > > > > >> > > > today, separate tickets for small > refactorings > > > has > > > > > > > lowest > > > > > > > > > > > > priority, > > > > > > > > > > > > >> > since > > > > > > > > > > > > >> > > > they neither fix any flaw nor add new > > > > functionality. > > > > > > > Also, > > > > > > > > > the > > > > > > > > > > > > >> > attempts to > > > > > > > > > > > > >> > > > make issue-related code safer / cleaner / > more > > > > > > readable > > > > > > > in > > > > > > > > > > > "real" > > > > > > > > > > > > >> pull > > > > > > > > > > > > >> > > > requests are typically rejected, since they > > > > > contradict > > > > > > > our > > > > > > > > > > > current > > > > > > > > > > > > >> > > > guidelines. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > I understand this will require a bit more > > effort > > > > > from > > > > > > > > > > > > >> > committer/maintainer, > > > > > > > > > > > > >> > > > but otherwise we will get constantly > degrading > > > > code > > > > > > > > quality. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > 2018-04-24 18:52 GMT+03:00 Eduard > Shangareev < > > > > > > > > > > > > >> > eduard.shangar...@gmail.com > > > > > > > > > > > > >> > > > > : > > > > > > > > > > > > >> > > > > Vladimir, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > I am not talking about > massive/sophisticated > > > > > > > > refactoring. > > > > > > > > > > But > > > > > > > > > > > I > > > > > > > > > > > > >> > believe > > > > > > > > > > > > >> > > > > that ask to extract some methods should be > > OK > > > to > > > > > do > > > > > > > > > without > > > > > > > > > > an > > > > > > > > > > > > >> extra > > > > > > > > > > > > >> > > > > ticket. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > A checklist shouldn't be necessarily a set > > of > > > > > > certain > > > > > > > > > rules > > > > > > > > > > > but > > > > > > > > > > > > >> also > > > > > > > > > > > > >> > it > > > > > > > > > > > > >> > > > > could include suggestion and reminders. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > On Tue, Apr 24, 2018 at 6:39 PM, Vladimir > > > > Ozerov < > > > > > > > > > > > > >> > voze...@gridgain.com> > > > > > > > > > > > > >> > > > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > > Ed, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > Refactoring is a separate task. If you > > would > > > > > like > > > > > > to > > > > > > > > > > rework > > > > > > > > > > > > >> > exchange > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > future > > > > > > > > > > > > >> > > > > > - please do this in a ticket "Refactor > > > > exchange > > > > > > > task", > > > > > > > > > > > nobody > > > > > > > > > > > > >> would > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > against > > > > > > > > > > > > >> > > > > > this. This is just a matter of creating > > > > separate > > > > > > > > ticket > > > > > > > > > > and > > > > > > > > > > > > >> > separate > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > PR. > > > > > > > > > > > > >> > > > > If > > > > > > > > > > > > >> > > > > > one have a time for refactoring, it > should > > > not > > > > > be > > > > > > a > > > > > > > > > > problem > > > > > > > > > > > > for > > > > > > > > > > > > >> > him to > > > > > > > > > > > > >> > > > > > spend several minutes on JIRA and > GitHub. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > As far as documentation - what you > > describe > > > is > > > > > > > normal > > > > > > > > > > review > > > > > > > > > > > > >> > process, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > when > > > > > > > > > > > > >> > > > > > reviewer might want to ask contributor > to > > > fix > > > > > > > > something. > > > > > > > > > > > > >> Checklist > > > > > > > > > > > > >> > is a > > > > > > > > > > > > >> > > > > > different thing - this is a set of rules > > > which > > > > > > must > > > > > > > be > > > > > > > > > > > > followed > > > > > > > > > > > > >> by > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > anyone. > > > > > > > > > > > > >> > > > > > I do not understand how you can define > > > > > > documentation > > > > > > > > in > > > > > > > > > > this > > > > > > > > > > > > >> > checklist. > > > > > > > > > > > > >> > > > > > Same problem with logging - what is > > > "enough"? > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > On Tue, Apr 24, 2018 at 4:51 PM, Eduard > > > > > > Shangareev < > > > > > > > > > > > > >> > > > > > eduard.shangar...@gmail.com> wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > > Igniters, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > I don't understand why you are so > > against > > > > > > > > refactoring. > > > > > > > > > > > > >> > > > > > > Code already smells like hell. Methods > > > 200+ > > > > > line > > > > > > > is > > > > > > > > > > > normal. > > > > > > > > > > > > >> > Exchange > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > future > > > > > > > > > > > > >> > > > > > > is asking to be separated on several > > one. > > > > > > > > Transaction > > > > > > > > > > code > > > > > > > > > > > > >> could > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > understand > > > > > > > > > > > > >> > > > > > > few people. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > If we separate refactoring from > > > development > > > > it > > > > > > > would > > > > > > > > > > mean > > > > > > > > > > > > that > > > > > > > > > > > > >> > no one > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > will > > > > > > > > > > > > >> > > > > > > do it. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > 2) Documentation. > > > > > > > > > > > > >> > > > > > > Everything which was asked by > reviewers > > to > > > > > > clarify > > > > > > > > > idea > > > > > > > > > > > > >> should be > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > reflected > > > > > > > > > > > > >> > > > > > > in the code. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > 3) Logging. > > > > > > > > > > > > >> > > > > > > Logging should be enough to > troubleshoot > > > the > > > > > > > problem > > > > > > > > > if > > > > > > > > > > > > >> someone > > > > > > > > > > > > >> > comes > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > to > > > > > > > > > > > > >> > > > > > > user-list with an issue in the code. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > On Fri, Apr 20, 2018 at 7:06 PM, > Dmitry > > > > > Pavlov < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > dpavlov....@gmail.com> > > > > > > > > > > > > >> > > > > > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > > Hi Igniters, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > +1 to idea of checklist. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > +1 to refactoring and documenting > code > > > > > related > > > > > > > to > > > > > > > > > > ticket > > > > > > > > > > > > in > > > > > > > > > > > > >> > +/-20 > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > LOC > > > > > > > > > > > > >> > > > > > at > > > > > > > > > > > > >> > > > > > > > least. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > If we start to do it as part of our > > > > regular > > > > > > > > > > > contribution, > > > > > > > > > > > > >> code > > > > > > > > > > > > >> > will > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > be > > > > > > > > > > > > >> > > > > > > > better, it would became common > > practice > > > > and > > > > > > part > > > > > > > > of > > > > > > > > > > > Apache > > > > > > > > > > > > >> > Ignite > > > > > > > > > > > > >> > > > > > > > development culure. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > If we will hope we will have free > time > > > to > > > > > > submit > > > > > > > > > > > separate > > > > > > > > > > > > >> patch > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > someday > > > > > > > > > > > > >> > > > > > > and > > > > > > > > > > > > >> > > > > > > > have patience to complete > > > patch-submission > > > > > > > > process, > > > > > > > > > > code > > > > > > > > > > > > >> will > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > remain > > > > > > > > > > > > >> > > > > > > > undocumented and poor-readable. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > Sincerely, > > > > > > > > > > > > >> > > > > > > > Dmitriy Pavlov > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > пт, 20 апр. 2018 г. в 18:56, > Александр > > > > > > > Меньшиков < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > sharple...@gmail.com > > > > > > > > > > > > >> > > > > > > : > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > > 4) Metrics. > > > > > > > > > > > > >> > > > > > > > > partially +1 > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > It makes sense to have some > minimal > > > code > > > > > > > > coverage > > > > > > > > > > for > > > > > > > > > > > > new > > > > > > > > > > > > >> > code in > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > PR. > > > > > > > > > > > > >> > > > > > > > IMHO. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > Also, we can limit the cyclomatic > > > > > complexity > > > > > > > of > > > > > > > > > the > > > > > > > > > > > new > > > > > > > > > > > > >> code > > > > > > > > > > > > >> > in > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > PR > > > > > > > > > > > > >> > > > > > too. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > 6) Refactoring > > > > > > > > > > > > >> > > > > > > > > -1 > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > I understand why people want to > > > refactor > > > > > old > > > > > > > > code. > > > > > > > > > > > > >> > > > > > > > > But I think refactoring should be > > > > always a > > > > > > > > > separate > > > > > > > > > > > > task. > > > > > > > > > > > > >> > > > > > > > > And it's better to remove all > > > > refactoring > > > > > > from > > > > > > > > PR, > > > > > > > > > > if > > > > > > > > > > > > it's > > > > > > > > > > > > >> > not > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > the > > > > > > > > > > > > >> > > > > > > sense > > > > > > > > > > > > >> > > > > > > > of > > > > > > > > > > > > >> > > > > > > > > the issue. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > 2018-04-20 16:54 GMT+03:00 Andrey > > > > > Kuznetsov > > > > > > < > > > > > > > > > > > > >> > stku...@gmail.com>: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > What about adding the following > > item > > > > to > > > > > > the > > > > > > > > > > > checklist: > > > > > > > > > > > > >> > when the > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > change > > > > > > > > > > > > >> > > > > > > > > adds > > > > > > > > > > > > >> > > > > > > > > > new functionality, then unit > tests > > > > > should > > > > > > > also > > > > > > > > > be > > > > > > > > > > > > >> > provided, if > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > it's > > > > > > > > > > > > >> > > > > > > > > > technically possible? > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > As for refactorings, in fact > they > > > are > > > > > > > strongly > > > > > > > > > > > > >> discouraged > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > today > > > > > > > > > > > > >> > > > > > for > > > > > > > > > > > > >> > > > > > > > some > > > > > > > > > > > > >> > > > > > > > > > unclear reason. Let's permit to > > make > > > > > > > > > refactorings > > > > > > > > > > in > > > > > > > > > > > > the > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > checklist > > > > > > > > > > > > >> > > > > > > > being > > > > > > > > > > > > >> > > > > > > > > > discussed. (Of cource, > refactoring > > > > > should > > > > > > > > relate > > > > > > > > > > to > > > > > > > > > > > > >> problem > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > being > > > > > > > > > > > > >> > > > > > > > > solved.) > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > 2018-04-20 16:16 GMT+03:00 > > Vladimir > > > > > > Ozerov < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > voze...@gridgain.com > > > > > > > > > > > > >> > > > > > : > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > Hi Ed, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > Unfortunately some of these > > points > > > > are > > > > > > not > > > > > > > > > good > > > > > > > > > > > > >> > candidates > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > for > > > > > > > > > > > > >> > > > > > the > > > > > > > > > > > > >> > > > > > > > > > > checklist because of these: > > > > > > > > > > > > >> > > > > > > > > > > - It must be clear and > disallow > > > > > > *multiple > > > > > > > > > > > > >> > interpretations* > > > > > > > > > > > > >> > > > > > > > > > > - It must be *lightweight*, > > > > otherwise > > > > > > > Ignite > > > > > > > > > > > > >> development > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > would > > > > > > > > > > > > >> > > > > > > > become a > > > > > > > > > > > > >> > > > > > > > > > > nightmare > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > We cannot have "nice to have" > > > points > > > > > > here. > > > > > > > > > > > Checklist > > > > > > > > > > > > >> > should > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > answer > > > > > > > > > > > > >> > > > > > > > the > > > > > > > > > > > > >> > > > > > > > > > > question "is ticket eligible > to > > be > > > > > > > merged?" > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 1) Code style. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > +1 > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 2) Documentation > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > -1, it is impossible to define > > > what > > > > is > > > > > > > > > > > > >> > "well-documented". A > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > piece > > > > > > > > > > > > >> > > > > > > of > > > > > > > > > > > > >> > > > > > > > > code > > > > > > > > > > > > >> > > > > > > > > > > could be obvious for one > > > > contributor, > > > > > > and > > > > > > > > > > > > non-obvious > > > > > > > > > > > > >> for > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > another. > > > > > > > > > > > > >> > > > > > > In > > > > > > > > > > > > >> > > > > > > > > any > > > > > > > > > > > > >> > > > > > > > > > > case this is not a blocker for > > > > merge. > > > > > > > > Instead, > > > > > > > > > > > > during > > > > > > > > > > > > >> > review > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > one > > > > > > > > > > > > >> > > > > > > can > > > > > > > > > > > > >> > > > > > > > > ask > > > > > > > > > > > > >> > > > > > > > > > > implementer to add more docs, > > but > > > it > > > > > > > cannot > > > > > > > > be > > > > > > > > > > > > forced. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 3) Logging > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > -1, same problem - what is > > "enough > > > > > > > > logging?". > > > > > > > > > > > Enough > > > > > > > > > > > > >> for > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > whom? > > > > > > > > > > > > >> > > > > > How > > > > > > > > > > > > >> > > > > > > to > > > > > > > > > > > > >> > > > > > > > > > > understand whether it is > enough > > or > > > > > not? > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 4) Metrics > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > -1, no clear boundaries, and > > > > decision > > > > > on > > > > > > > > > whether > > > > > > > > > > > > >> metrics > > > > > > > > > > > > >> > are > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > to > > > > > > > > > > > > >> > > > > > be > > > > > > > > > > > > >> > > > > > > > > added > > > > > > > > > > > > >> > > > > > > > > > or > > > > > > > > > > > > >> > > > > > > > > > > not should be performed during > > > > design > > > > > > > phase. > > > > > > > > > As > > > > > > > > > > > > >> before, > > > > > > > > > > > > >> > it is > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > perfectly > > > > > > > > > > > > >> > > > > > > > > > > valid to ask contributor to > add > > > > > metrics > > > > > > > with > > > > > > > > > > clear > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > explanation > > > > > > > > > > > > >> > > > > > why, > > > > > > > > > > > > >> > > > > > > > but > > > > > > > > > > > > >> > > > > > > > > > > this is not part of the > > checklist. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 5) TC status > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > +1, already mentioned > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 6) Refactoring > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > Strong -1. OOP is a slippery > > > slope, > > > > > > there > > > > > > > > are > > > > > > > > > no > > > > > > > > > > > > good > > > > > > > > > > > > >> > and bad > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > >> > > > > > > > receipts > > > > > > > > > > > > >> > > > > > > > > > for > > > > > > > > > > > > >> > > > > > > > > > > all cases, hence it cannot be > > used > > > > in > > > > > a > > > > > > > > > > checklist. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > We can borrow useful rules > from > > > p.2, > > > > > p.3 > > > > > > > and > > > > > > > > > p.4 > > > > > > > > > > > if > > > > > > > > > > > > >> you > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > provide > > > > > > > > > > > > >> > > > > > > clear > > > > > > > > > > > > >> > > > > > > > > > > definitions on how to measure > > > them. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > Vladimir. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > On Fri, Apr 20, 2018 at 3:50 > PM, > > > > > Eduard > > > > > > > > > > > Shangareev < > > > > > > > > > > > > >> > > > > > > > > > > eduard.shangar...@gmail.com> > > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > Also, I want to add some > > > technical > > > > > > > > > > requirement. > > > > > > > > > > > > >> Let's > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > discuss > > > > > > > > > > > > >> > > > > > > them. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 1) Code style. > > > > > > > > > > > > >> > > > > > > > > > > > The code needs to be > formatted > > > > > > according > > > > > > > > to > > > > > > > > > > > coding > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > guidelines > > > > > > > > > > > > >> > > > > > > > > > > > < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > https://cwiki.apache.org/ > > > > > > > > > confluence/display/IGNITE/ > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > Coding+Guidelines > > > > > > > > > > > > >> > > > > > > > > > > . > > > > > > > > > > > > >> > > > > > > > > > > > The > > > > > > > > > > > > >> > > > > > > > > > > > code must not contain TODOs > > > > without > > > > > a > > > > > > > > ticket > > > > > > > > > > > > >> reference. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > It is highly recommended to > > make > > > > > major > > > > > > > > > > > formatting > > > > > > > > > > > > >> > changes > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > in > > > > > > > > > > > > >> > > > > > > > existing > > > > > > > > > > > > >> > > > > > > > > > > code > > > > > > > > > > > > >> > > > > > > > > > > > as a separate commit, to > make > > > > review > > > > > > > > process > > > > > > > > > > > more > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > practical. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 2) Documentation. > > > > > > > > > > > > >> > > > > > > > > > > > Added code should be > > > > > well-documented. > > > > > > > Any > > > > > > > > > > > methods > > > > > > > > > > > > >> that > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > raise > > > > > > > > > > > > >> > > > > > > > > questions > > > > > > > > > > > > >> > > > > > > > > > > > regarding their code flow, > > > > > invariants, > > > > > > > > > > > > >> synchronization, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > etc., > > > > > > > > > > > > >> > > > > > > must > > > > > > > > > > > > >> > > > > > > > be > > > > > > > > > > > > >> > > > > > > > > > > > documented with > comprehensive > > > > > javadoc. > > > > > > > Any > > > > > > > > > > > > reviewer > > > > > > > > > > > > >> can > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > request > > > > > > > > > > > > >> > > > > > > > that > > > > > > > > > > > > >> > > > > > > > > a > > > > > > > > > > > > >> > > > > > > > > > > > particular added method be > > > > > documented. > > > > > > > > Also, > > > > > > > > > > it > > > > > > > > > > > > is a > > > > > > > > > > > > >> > good > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > practice > > > > > > > > > > > > >> > > > > > > > to > > > > > > > > > > > > >> > > > > > > > > > > > document old code in a 10-20 > > > lines > > > > > > > region > > > > > > > > > > around > > > > > > > > > > > > >> > changed > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > code. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 3) Logging. > > > > > > > > > > > > >> > > > > > > > > > > > Make sure that there are > > enough > > > > > > logging > > > > > > > > > added > > > > > > > > > > in > > > > > > > > > > > > >> every > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > category > > > > > > > > > > > > >> > > > > > > for > > > > > > > > > > > > >> > > > > > > > > > > > possible diagnostic in > field. > > > > Check > > > > > > that > > > > > > > > > > logging > > > > > > > > > > > > >> > messages > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > are > > > > > > > > > > > > >> > > > > > > > > properly > > > > > > > > > > > > >> > > > > > > > > > > > spelled. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 4) Metrics. > > > > > > > > > > > > >> > > > > > > > > > > > Are there any metrics that > > need > > > to > > > > > be > > > > > > > > > exposed > > > > > > > > > > to > > > > > > > > > > > > >> user? > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 5) TC status. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > Recheck that there are no > new > > > > > failing > > > > > > > > tests > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > 6) Refactoring. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > The code should be better > than > > > > > before: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > - extract method from big > > > one; > > > > > > > > > > > > >> > > > > > > > > > > > - do anything else to > make > > > code > > > > > > > clearer > > > > > > > > > > > (don't > > > > > > > > > > > > >> > forget > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > >> > > > > about > > > > > > > > > > > > >> > > > > > > some > > > > > > > > > > > > >> > > > > > > > > > > > OOP-practise, replace > > if-else > > > > > hell > > > > > > > with > > > > > > > > > > > > >> inheritance > > > > > > > > > > > > >> > > > > > > > > > > > - split refactoring > > > (renaming, > > > > > code > > > > > > > > > format) > > > > > > > > > > > > from > > > > > > > > > > > > >> > actual > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > changes > > > > > > > > > > > > >> > > > > > > > by > > > > > > > > > > > > >> > > > > > > > > > > > separate commit > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > On Fri, Apr 20, 2018 at 3:23 > > PM, > > > > > > Eduard > > > > > > > > > > > > Shangareev < > > > > > > > > > > > > >> > > > > > > > > > > > eduard.shangar...@gmail.com > > > > > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > Hi, guys. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > I believe that we should > > > update > > > > > > > > > maintainers > > > > > > > > > > > list > > > > > > > > > > > > >> > before > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > >> > > > > > adding > > > > > > > > > > > > >> > > > > > > > this > > > > > > > > > > > > >> > > > > > > > > > > > review > > > > > > > > > > > > >> > > > > > > > > > > > > requirement. > > > > > > > > > > > > >> > > > > > > > > > > > > There should not be the > > > > situation > > > > > > when > > > > > > > > > there > > > > > > > > > > > is > > > > > > > > > > > > >> only > > > > > > > > > > > > >> > one > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > contributor > > > > > > > > > > > > >> > > > > > > > > > > who > > > > > > > > > > > > >> > > > > > > > > > > > > is responsible for a > > > component. > > > > > > > > > > > > >> > > > > > > > > > > > > We already have issues > with > > > > review > > > > > > > speed > > > > > > > > > and > > > > > > > > > > > > >> response > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > time. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > On Fri, Apr 20, 2018 at > 2:17 > > > PM, > > > > > > Anton > > > > > > > > > > > > Vinogradov > > > > > > > > > > > > >> < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > a...@apache.org > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > wrote: > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > Vova, > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > Everything you described > > > sound > > > > > > good > > > > > > > to > > > > > > > > > me. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > I'd like to propose to > > > create > > > > > > > special > > > > > > > > > page > > > > > > > > > > > at > > > > > > > > > > > > AI > > > > > > > > > > > > >> > Wiki > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > and > > > > > > > > > > > > >> > > > > to > > > > > > > > > > > > >> > > > > > > > > > describe > > > > > > > > > > > > >> > > > > > > > > > > > > > checklist. > > > > > > > > > > > > >> > > > > > > > > > > > > > In case we'll find > > something > > > > > > should > > > > > > > be > > > > > > > > > > > > >> > changed/improved > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > it > > > > > > > > > > > > >> > > > > > > will > > > > > > > > > > > > >> > > > > > > > be > > > > > > > > > > > > >> > > > > > > > > > > easy > > > > > > > > > > > > >> > > > > > > > > > > > to > > > > > > > > > > > > >> > > > > > > > > > > > > > update the page. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > 2018-04-20 0:53 > GMT+03:00 > > > > > Nikolay > > > > > > > > > Izhikov > > > > > > > > > > < > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > nizhi...@apache.org > > > > > > > > > > > > >> > > > > > > > > : > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > Hello, Vladimir. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > Thank you for seting > up > > > this > > > > > > > > > discussion. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > As we discussed, I > think > > > an > > > > > > > > important > > > > > > > > > > part > > > > > > > > > > > > of > > > > > > > > > > > > >> > this > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > check > > > > > > > > > > > > >> > > > > > > list > > > > > > > > > > > > >> > > > > > > > is > > > > > > > > > > > > >> > > > > > > > > > > > > > > compatibility rules. > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > * What should be > > backward > > > > > > > > compatible? > > > > > > > > > > > > >> > > > > > > > > > > > > > > * How should we > maintain > > > it? > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > > 3) If ticket changes > > > > public > > > > > > API > > > > > > > or > > > > > > > > > > > > existing > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > behavior, > > > > > > > > > > > > >> > > > > at > > > > > > > > > > > > >> > > > > > > > least > > > > > > > > > > > > >> > > > > > > > > > two > > > > > > > > > > > > >> > > > > > > > > > > > > > > commiters should > approve > > > the > > > > > > > changes > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > > > >> > > > > > > > > > > > > > > We can learn from > other > > > open > > > > > > > source > > > > > > > > > > > project > > > > > > > > > > > > >> > > > > > > > > > > > > > > > >> > > > experience. > > > > > > > > > > > > >> > > > > > > > > > > > > > > Apache Kafka [1], for > > > > example, > > > > > > > > > requires > > > > > > > > > > > > >> KIP(kafka > > > > > > > > > > > > >> > > > > > > > > > > > > > > > > > > >> > > > > > > improvement > > > > > > > > > > > > >> > > > > > > > > > > > proposal) > > > > > > > >