=== salgado-afk is now known as salgado [15:04] #startmeeting [15:04] Meeting started at 09:04. The chair is barry. [15:04] Commands Available: [TOPIC], [IDEA], [ACTION], [AGREED], [LINK], [VOTE] [15:04] hello everyone and welcome to this week's ameu reviewers meeting. who's here today? [15:04] me [15:04] me [15:05] me [15:05] me [15:05] me [15:05] me [15:05] me [15:06] adeuring: ping [15:06] allenap: ping [15:06] me [15:06] bac: ping [15:06] BjornT: ping [15:06] me [15:06] cprov: ping [15:06] me [15:06] mars: ping [15:07] sinzui: ping [15:07] [TOPIC] agenda [15:07] New Topic: agenda [15:07] * Roll call [15:07] * Peanut gallery (anything not on the agenda) [15:07] * Action items [15:07] * Mentoring update [15:07] * Code must be used once or more to land (excluding tests) (intellectronica) [15:07] * Avoid refactoring both code and tests in the same branch (intellectronica) [15:08] me [15:08] let's skip around a bit [15:08] me [15:08] [TOPIC] * Code must be used once or more to land (excluding tests) (intellectronica) [15:08] New Topic: * Code must be used once or more to land (excluding tests) (intellectronica) [15:08] intellectronica: the floor is yours [15:09] this follows from a discussion we had a couple of weeks ago in the ajax swat team [15:09] working on general purpose solutions before they are being used is risky and hard [15:09] me [15:09] and we want to avoid that as much as possible, especially when working on JS code [15:09] intellectronica: what if we are not talking about general purpose solutions but parts of solutions? [15:10] danilos: same thing [15:10] (I know what you are aiming at, but the problem is more generic: just like there's a rule to not do premature optimization, we should not over-design stuff up-front, but let the design evolve from actual use cases) [15:10] anyway, this is pretty much policy now, and shouldn't be debated here. the only relevant point for reviews is: [15:10] well, I strongly disagree [15:10] so do I [15:10] intellectronica: i think i agree with danilos [15:11] it's ok to land something that isn't used, if you intend to use it in the next branch [15:11] it helps keeping the branches small [15:11] BjornT: +1 [15:11] me too; the rule is in many cases useful, but i think there are many exceptions [15:11] BjornT: it's ok if it's not in the same branch, but the reviewer should inquire about that, and maybe ask to see the branch where it's being used [15:11] landing something that you think will be useful, but don't have any plans to use should of course be discouraged [15:11] BjornT: i agree, i just wouldn't call that "not used" :) i.e. it's just an artificial decomposition to keep branches manageable [15:12] database patches are a classic example -- you land them first and use them later [15:12] how would this work with landing DB patches a cycle before? that's a clear violation of the rule, or it means waiting two cycles "for nothing"? [15:12] lazr code, for example, will, by-definition, not be in the same branch as the launchpad code that uses it [15:13] al-maisan: db-patches are always *used* since the current code has to cope with it. [15:13] danilos: this is particulary relevant for javascript code. deviations are ok at your discretion. and of course stuff like db patches must me done that way, and is pretty low risk [15:13] i also think it's fine to question code that you don't see used in a branch, and it's fine if the dev says "oh, that's in the next branch" [15:13] I guess we need to agree on what constitutes "use" then [15:13] intellectronica: which means it's not a rule, but a recommendation, specifically aimed at JS work, and should be described as such (IMO, at least) [15:14] barry: right. it's ok to question it, as long as it's allowed to land such branches [15:14] barry: we've done that for ages, but I am willing to hear out intellectronica concrete recommendations for JS [15:14] :) [15:14] BjornT: +1 [15:15] danilos: i'm all for avoiding premature generalizations :) [15:15] :) [15:15] let's use our common sense. what we're trying to discourage is the development of general-purpose solutions separately from using them, where the risk is high [15:16] intellectronica: i get that, esp. for js stuff. you think you see a general pattern when doing some ui stuff before it's proven itself [15:16] b.t.w if you haven't already, please read the relevant post to the mailing list. i only wanted to mention this here because reviews are the last point in the development cycle where we can stop this [15:16] what we really want to do is think about this pre-implementation [15:16] intellectronica: it feels to me reviews are a bit too late to think about this [15:17] danilos: i agree [15:17] but if this wasn't done before, reviews are our last chance, before unused, and possibly unusable, code, lands [15:17] intellectronica: you are only going to get negative opinions of the review process if you get blocked at that final step; I think that's something we should encourage in pre-imp calls [15:18] danilos: you can gain something from identifying this in a review. the acknowledgedment that the work is incomplete [15:18] the direct result will be that the work can be completed immediately, instead of shelved for a while, which is almost always worse [15:19] intellectronica: that's ok as long as it's not a de facto blocker for landing stuff... I see the point, but it should clearly be at reviewers' discretion [15:19] i actually don't think this is a big departure from current practice, unless intellectronica is saying we MUST reject such branches [15:19] barry: I was under the impression he was, which is why you hear me complaining :) [15:19] barry: we only MUST reject lazr-js branches like this. everything else is open for negotiation [15:20] intellectronica: isn't this why we have the ui= tag now? [15:20] I think the JS general purpose solutions are little different, since we usually know that we are going to re-use them, but this increases the size of the project to several weeks. I don't think that whether we know we will use the general purpose solution is a good question to help decide where to split up the increments. [15:20] I think we are departing from agile development as much as we can, and I don't like that [15:20] barry: no. beuno is unlikely to pay attention to this in his review. he reviews the UI itself, not the code or how it's structured [15:20] danilos: hmm, not really, continuous integration is agile [15:21] danilos: how so? that sounds very agile to me [15:21] for lazr-js, we should definitely have nicer way to add JS directly into LP tree, and then we wouldn't even be having this discussion [15:21] danilos: and basically what intellectronica is arguing against is landing unintegrated code [15:21] danilos: no, it's not about that [15:21] flacoste: exactly! [15:21] danilos: it's about not developping widgets that don't have an integration scenario [15:21] flacoste: well, the code is used in the sample page in lazr-js [15:22] flacoste: as I said, I see the point, I think the approach to solving it is completely wrong [15:22] danilos: yes, but that's what intellectronica is arguing against, the example page should be developped later, not as the first integration case [15:22] danilos: there's no problem adding js code to the LP tree, and in fact my recommendation is that you develop like that and only move the code to lazr-js when it's ready. but that's up to the developer, on a case by case basis [15:22] flacoste: in practice, you'll have people develop lazr-js widgets, then having that sit (with small changes) while they fight over integrating it [15:22] intellectronica: that seems like a reasonable approach to me [15:22] danilos: right, and that's exactly what we're trying to avoid [15:23] intellectronica: the problem is that it's not clear what the best practice is [15:23] danilos: please refer to the email thread, if you haven't read it yet [15:23] the best practice is "integration first" [15:23] intellectronica: well, then reviewers meeting is completely wrong place to discuss it, and other than engaging in pre-imp calls, I don't want to block branches at review stage [15:23] intellectronica: as I said, I agree with that, but don't see how it's relevant to blocking at review level [15:24] i think you're right that it's better to discuss this policy further on the ml thread [15:24] i agree that this is not relevant _just_ to reviews, i only wanted to mention this because this is our last opportunity to deal with this. ideally, we should plan to work like that from the beginning, and you won't see this in reviews very often [15:24] i.e. "you *should* have done this completely differently" -- if we get to that point, we are doing something badly [15:24] well, the policy is kind of in place [15:24] barry: i agree [15:24] reviewers should just be mindful of it [15:24] and remember [15:25] reviewers are good candidates for pre-impl call [15:25] so i think that this topic was more about [15:25] "make sure you are up-to-date with the mailing-list thread" :-) [15:25] flacoste: +1 [15:25] flacoste: +1 [15:25] with that, i think we can move on [15:25] thanks. let's move on [15:26] [TOPIC] * Avoid refactoring both code and tests in the same branch (intellectronica) [15:26] New Topic: * Avoid refactoring both code and tests in the same branch (intellectronica) [15:26] ah yes, another issue that's not really about reviews :) [15:26] well, I feel this one is, because it's much harder to review stuff that combines refactoring of both [15:26] :) [15:27] danilos: yes. it came up in a review :) [15:27] as long as the refactoring isn't necessary to actually keep the test suite happy [15:27] barry: of course [15:27] or if the refactoring is "minor" [15:27] of course [15:27] danilos: will you disagree of anything intellectronica says today ? :) [15:27] danilos is looking for a fight i think ;-) [15:28] cprov: you mean agree? :) [15:28] * barry wonders who's gonna get voted off the channel today [15:28] well, I am agreeing with intellectronica this time (at least the topic he proposed :), it's just that he seemed a bit uncertain after the first one :) [15:28] danilos: I dunno, you tell me ... [15:29] do we need to discuss this topic more? [15:29] not as far as i'm concerned [15:29] maybe we could just put up some ads saying that if you (developer) refactor just code, you may get an rs= for some reviewer [15:29] anyway, this is a good think to point out, but we should make this a bit more well advertised imo [15:29] salgado: ah, sounds really nice! [15:29] salgado: +1 [15:30] however, if you refactor both code and tests, you'll need a real review that may take much longer [15:30] provided there's existing test coverage for the code [15:30] that way we encourage them to do what's more appropriate [15:30] s/them/us [15:31] stupid question: why are we not to refactor both code and tests in the same branch? Because of the size? [15:31] salgado: i'm all for making it easier to land tech debt reduction branches [15:31] al-maisan: no, because when you refactor only code, and tests still pass, we have much bigger certainty that your refactoring is good (even if we don't understand all the gory details of your code) [15:32] aha [15:32] danilos: so maybe we need even more scrutiny of test refactoring branches? [15:32] al-maisan, IMO, it makes it harder to find whether or not your test refactoring left any code untested [15:32] al-maisan: no, because part of the utility provided by the test suite is confirming that your refactoring is ok [15:32] thanks! [15:32] * noodles775 would love to have a refactor-only branch :) [15:32] salgado: I was planning to get lots of rs's from you on Friday to move some tests and rm some empty directories created by the migration script [15:32] barry: maybe, but I'd be scared of proposing that :) [15:33] :) [15:33] sinzui, I'd be glad to give you them, but Friday is a holiday here [15:33] sinzui: i think it's only /not/ a holiday in the us [15:33] salgado: then I will ask your your rs tomorrow [15:33] anyway, I think salgado's idea is a nice one, and we can start offering rs=me for code refactoring only branches [15:34] danilos: i'd be okay with that [15:34] i'm not sure i understand what the difference is, in this case [15:34] you're still required to actually review the code, right? [15:34] intellectronica: this is just a way of promoting it [15:35] intellectronica: well, if the tests pass and aren't touched... [15:35] intellectronica: I think that's what's missing, telling people how we like our code baked [15:35] seems confusing to me, and i don't see the benefits [15:35] the way I was thinking, I'd glance through the code, check that there are no changes to tests and give an rs=me if the test suite pass [15:36] salgado: but there are other aspects of the code you'll want to review, no? [15:36] and it might still be worth a 3rd party review to ensure there is good test coverage in the first place. [15:36] salgado: I'd also like to be pointed at existing test for that particular code :) [15:36] danilos: exactly. [15:36] intellectronica, depending on the kind of the refactoring, yes [15:36] that it's well documented, orgnised in a maintainable fashion, formatted correctly, etc [15:37] salgado: that sounds more like an easy r=me than an rs [15:37] intellectronica, I'd decide that after reading the cover letter and glancing through the diff [15:37] salgado: sure, makes sense [15:38] anyway, shall we move on? [15:38] [TOPIC] action items [15:38] New Topic: action items [15:38] cprov, I don't agree. even when I give an rs=me, I usually glance at the diff [15:38] * flacoste to look into storm/sqlobject result set compatibility [15:38] they're imcompatible [15:38] and not meant to be compatible [15:39] * flacoste to work on API reviewer cheat sheet [15:39] i started [15:39] will finish for next week [15:40] i promise [15:40] although it's not worth much these days [15:40] flacoste: which one? [15:40] cheat sheet [15:40] cool [15:40] flacoste: because of the economy crisis, or? :) [15:40] the previous is actually on allenap plate [15:40] lol [15:40] salgado: maybe, but it's seems to be all about offering review-friendly code, sometimes r sometimes rs, the difference isn't very clear. [15:40] flacoste: okay, i'll change that [15:41] salgado: (not necessarily disagreeing on what you said, now.) [15:41] cprov: rs= almost always means "i didn't look at it, i trust you" [15:41] flacoste: Do we want to try and update the Storm tree we're using, or shall I back port the IResultSet adapter? [15:41] allenap: better to backport [15:41] allenap: we are looking at updating Storm, but there was a bunch test failures [15:42] allenap: so if we want it now, it's a lot easier to backport and I think that it's a fairly small change? [15:42] flacoste: maybe it's something for each team to look into (if you have a branch with updated Storm, I'd be happy to have translations-related tests looked over) [15:42] flacoste: Yep, it merges cleanly, or at least it did last time I tried. [15:42] anyway, not the right place for this discussion, I guess [15:43] yep, we'll keep it on the agenda for next week [15:43] gary's not here so we'll skip his action item [15:44] since we're almost out of time, i'll just ask if there's anything quick anybody else has? [15:45] 5...4...3...2...1 [15:45] #endmeeting [15:45] Meeting finished at 09:45. [15:45] thanks everyone! === salgado is now known as salgado-lunch === salgado-lunch is now known as salgado === mrevell is now known as mrevell-dinner === salgado is now known as salgado-afk === _thumper_ is now known as thumper