/srv/irclogs.ubuntu.com/2008/11/12/#launchpad-meeting.txt

=== Moot2 is now known as MootBot
=== salgado-afk is now known as salgado
=== mrevell is now known as mrevellunch
=== mrevellunch is now known as mrevell
barry#startmeeting15:00
MootBotMeeting started at 09:00. The chair is barry.15:00
MootBotCommands Available: [TOPIC], [IDEA], [ACTION], [AGREED], [LINK], [VOTE]15:00
barrywelcome everyone to this week's ameu launchpad reviewer's meeting.  who's here today?15:00
allenapme15:00
abentleyme15:00
beunome15:00
rockstarme15:00
BjornTme15:00
intellectronicame15:00
barrycprov, danilos ping15:01
barryEdwinGrubbs: flacoste ping15:02
flacosteme15:02
barrysalgado: ping15:02
EdwinGrubbsme15:02
barrymars: ping15:02
sinzuime15:02
salgadome!15:02
intellectronicamrevell: are you joining the meeting? might make sense given that you've added an agenda item15:03
bigjoolsme15:03
mrevellSorry, me15:03
adeuringme15:03
bigjoolscprov is in Lexington and will probably not make any meetings this week15:04
barry[TOPIC]  * Roll call15:04
barry * using reST - flacoste15:04
barry * What support can beuno and mrevell offer during the review process? (mrevell)15:04
barry * If there's time, the old boring script15:04
barry   * Next meeting15:04
MootBotNew Topic:   * Roll call15:04
barry   * Action items15:04
barry   * Queue status15:04
barry   * Mentoring update15:04
barryer15:04
barry[TOPIC] agenda15:04
MootBotNew Topic:  agenda15:04
barry * Roll call15:04
barry * using reST - flacoste15:04
barry * What support can beuno and mrevell offer during the review process? (mrevell)15:04
barry * If there's time, the old boring script15:04
barry   * Next meeting15:04
barry   * Action items15:04
barry   * Queue status15:04
barry   * Mentoring update15:04
barry[TOPIC]  * using reST - flacoste15:04
MootBotNew Topic:   * using reST - flacoste15:04
barryflacoste: the floor is yours15:04
flacosteok15:04
flacosteso, like was discussed on the previous meeting where this topic was raised15:05
danilosme15:05
flacostegary did a a little experiment showing how the documentation and doctest of launchpadlib would look like15:05
flacosteonce post-processed by Sphinx15:05
flacosteand it was discussed on list15:05
flacosteare we ready to move forward and to change the Moin heading policy?15:06
flacosteso that our doctest and format is more in line with the rest of the python world15:06
BjornTi have one final question15:06
flacosteok15:06
* sinzui prepares script to remove the SteveA-approved headers15:07
BjornThow do we intend to use the newly created ReSt documents? i mean, i can't imaging running sphinx over the existing doc/ directory to make much sense. are we going to change the way we write (how they look like and where they should be placed) as well, if we switch to ReST?15:07
BjornTi think we should change the structure of doc/ anyway, but that should be done before/during the switch to ReST, otherwise it doesn't make much sense15:08
barryBjornT: i do think we need to adjust our doctest focus and organization, but that could be a big task15:08
barryBjornT: agreed, though this does get us in the habit of writing rest instead15:08
flacosteyes, one plan is to reorganize doc15:09
BjornTbarry: there's this risk of us only switching to rest, but not using it for anything :)15:09
flacostean idea I suggested was to group tests by application area15:09
flacosteand then link them in doc15:09
barryBjornT: i really hope that isn't the case :)15:10
BjornTi'd like to see a plan for this. one alternative would be to require rest only for those new doctests that are intended to be processed by sphinx15:10
flacostei think processing doc using sphinx isn't that crazy at first15:10
intellectronicai, for one, am quite comfortable reading doctests as text. it's api documentation that would benefit from formatting, imo15:10
BjornTbarry: well, we used to use ReST in the past, but didn't do anything with it15:10
flacosteit would be easier to find stuff that way than by browsing the directory anyway15:10
danilosintellectronica: +115:10
barryflacoste: agreed15:11
sinzuiflacoste: are you proposing that we merge the interface and doc tests for an application together?15:11
flacostesinzui: i'm not sure i understand15:11
flacostethe question, but my gut says "not really"15:11
sinzuiinterfaces/ftests/questiontarget15:11
flacostesinzui: a yes, that would makes sense15:12
barryBjornT: i agree w/flacoste.  let's restify+sphinxify right now.  we can improve the content and reorg over time15:12
flacostei propose the following plan, which is cheap:15:12
flacosteuse reST in doctests15:12
flacoste2) run sinzui script to reSTify all headers15:12
flacoste3) setup sphinx to generate API docs + doctests (unsorted)15:13
flacosteseveral iterations of refactor the big pile so that the generated stuff looks better organized and stuff15:13
barryflacoste: +115:13
flacostebtw, rs=flacoste on any landing doing 2)15:13
intellectronicai would start with generating api docs. i think that we'll get value immediately from doing that15:14
* barry tells sinzui to jfdi15:14
BjornTbarry, flacoste: well, to summarize. i'm -1 to switch to ReST without any concrete plans. -0 if we have a plan, and we start to do something (useful) with them immediately. (i'm -0, since the cost of switching is quite high, imo)15:14
flacosteso far, only barry, Bjorn and me have expressed an opinion15:15
intellectronicai agree with BjornT here. i really don't see what's the immediate benefit, especially as far as doctests are concerned15:15
rockstarflacoste, jfdi I guess.  I don't have any objections.15:15
sinzui+115:15
abentley+115:15
flacosteintellectronica: to me the most immediate benefit is convergence with the python community15:16
bigjoolsfor me, I don't know what benefits ReST brings either15:16
intellectronicaflacoste: how is that going to benefit us?15:16
BjornTit would also be interesting to know how many intend to read the sphinx processed doctests15:16
* sinzui start next script to PEP-8 all methods15:16
BjornTi for one wouldn't, that's why i'm a bit against it ;)15:16
beunouhm, +1. It's easier to manipulate ReST15:16
barrylet me ask a different question.  what benefit is moin markup to us?15:16
barryespecially given the meager markup we have in doctests anyway?15:16
bigjoolsthat's not a good question, you need to justify ReST15:16
flacosteintellectronica: as we push packages to PyPI (lazr.config, launchpadlib, wadlib, etc.)15:17
* barry pushes jml's and my branch to sinzui15:17
BjornTbeuno: easier than manipulating what? at the moment the only thing we use are moin headers. moin headers are easier than ReST headers :)15:17
intellectronicabarry: it's an agreed standard of which we have many documents and which requires no special effort from us right now15:17
BjornTbarry: what benefit is any markup?15:17
BjornTbarry: considering that we basically don't use any today15:17
intellectronicaflacoste: right, that's a good point. let's consider this again when we're ready to push the first package out, then15:18
bigjoolsthe great thing about standards is that there's so many to choose from!15:18
flacosteintellectronica: we are15:18
flacostelazr.config, launchpadlib, wadllib are ready to move out15:18
barrybigjools: haven't we done that?  convergence with the rest of python.  laying down consistency so that our doc reorg and produce meaningful html.15:18
flacostelaunchpadlib and wadllib are already out (though not on PYPI)15:18
flacosteand lazr.config is coming out next month15:18
flacosteintellectronica: and remember that launchpad is going open source in less than 10 months15:19
flacosteso it's going to happen more and more15:19
barryBjornT: if we have almost no markup now, what's the objection to using almost no rest vs using almost no moin? :)15:19
intellectronicaflacoste: maybe we can use them as a test bed, instead of taking on the mammoth task of converting the entire launchpad codebase just like that15:19
bigjoolsbarry: well my point is that we don't need to justify Moin, we already use it :)15:19
BjornTbarry: because is i said, moin headers are easier to write than rest headers :)15:19
flacosteintellectronica: it's not a big deal, sinzui has a script for it, and we used reST headers in the past15:20
flacosteso you can still find some in the tree15:20
bigjoolsfrom a pure human readability PoV, moin wins for me15:20
barrybigjools: we can have subjective differences about that :)  i find rest headers much more readable15:20
bigjools:)15:21
intellectronicai think that moin is more writable. readability is not very different15:21
abentleybigjools: Not for me.  Moin is the only place I've ever seen headlines done that way.  But text docs since the 80's have used underlines for headings.15:21
barryabentley: exactly15:21
* bigjools is outvoted15:21
barrylet's do a mootbot vote15:21
abentleyAnd we are only arguing about headings because that's all we're using, right?15:22
barry[VOTE] +1 == switch to rest; -1 == stick with moin15:22
MootBotPlease vote on:  +1 == switch to rest; -1 == stick with moin.15:22
MootBotPublic votes can be registered by saying +1/-1/+0 in the channel, private votes by messaging the channel followed by +1/-1/+0  to MootBot15:22
MootBotE.g. /msg MootBot +1 #launchpad-meeting15:22
barryabentley: right15:22
barry+115:22
MootBot+1 received from barry. 1 for, 0 against. 0 have abstained. Count is now 115:22
bigjoolswe already changed doctest markup once before, heck let's do it again15:22
sinzuiabentley: correct15:22
rockstar+115:22
MootBot+1 received from rockstar. 2 for, 0 against. 0 have abstained. Count is now 215:22
sinzui+115:22
MootBot+1 received from sinzui. 3 for, 0 against. 0 have abstained. Count is now 315:22
abentley+115:22
MootBot+1 received from abentley. 4 for, 0 against. 0 have abstained. Count is now 415:22
intellectronica-115:22
MootBot-1 received from intellectronica. 4 for, 1 against. 0 have abstained. Count is now 315:22
BjornT-115:22
adeuring+015:22
MootBot-1 received from BjornT. 4 for, 2 against. 0 have abstained. Count is now 215:22
MootBotAbstention received from adeuring. 4 for, 2 against. 1 have abstained. Count is now 215:22
EdwinGrubbs+015:22
MootBotAbstention received from EdwinGrubbs. 4 for, 2 against. 2 have abstained. Count is now 215:22
bigjools-115:22
MootBot-1 received from bigjools. 4 for, 3 against. 2 have abstained. Count is now 115:22
flacoste+115:22
MootBot+1 received from flacoste. 5 for, 3 against. 2 have abstained. Count is now 215:22
salgado+015:23
MootBotAbstention received from salgado. 5 for, 3 against. 3 have abstained. Count is now 215:23
barry5...15:24
barry4...15:24
barry3...15:24
barry2...15:24
barry1...15:24
barryrest wins :)15:24
barryflacoste: thanks15:24
barry[TOPIC]  * What support can beuno and mrevell offer during the review process? (mrevell)15:25
MootBotVote is in progress. Finishing now.15:25
MootBotFinal result is 5 for, 3 against. 3 abstained. Total: 215:25
MootBotNew Topic:   * What support can beuno and mrevell offer during the review process? (mrevell)15:25
mrevellHello!15:25
mrevellJust a simply question from me: how can beuno and I help during the review process with UI and any associated text, respectively?15:25
intellectronicareviewers should CC you when they receive a review where input from you would be beneficial, i think15:26
barrymrevell, beuno you are always welcome, nay encouraged to join our reviewers meetings (even the asiapac ones if you want to stay up late :)15:26
abentleymrevell: Ideally people would ping you before it got to review.15:26
mrevellbarry: I'd be very happy to attend the meetings if I can be of use.15:26
=== salgado is now known as salgado-lunch
mrevellabentley: Yeah, although that doesn't really happen in my case.15:26
barryintellectronica: you can, and i have, added beuno (but also mrevell) on a merge-proposal review15:26
bigjoolsfor me, review time is a little late for discussing UI changes15:27
mrevellbigjools: UI, sure, but maybe not UI text/documentation/announcements, is it?15:27
barrybigjools: yes, note that's not the the exclusion of including mrevell and beuno in a pre-imp call15:27
intellectronicabarry: yes, when i say CC this is really what i mean. email? that's so passe comose15:27
* beuno will be happy to assist the meetings, I may just forget, so ping me and I'll be here :)15:27
rockstarmrevell, maybe it needs to happen.15:27
rockstarMaybe me need to ask "Did you consult with (mrevell|beuno) on <x-feature>?"15:28
sinzuimrevell: Do you start documentation when a branch lands of staging?15:28
mrevellI'd love to take part in pre-imp calls. It's a great way for me to get a feel for what needs announcing etc.15:28
bigjoolsmrevell: +115:28
barryintellectronica: :)15:28
beunoI'm being included in more and more pre-imp calls, so I think that's going rather well from my perspective15:28
intellectronicamrevell: this sort of stuff usually doesn't make it into the codebase, but if you think that it would benefit from the same process we can do that15:28
mrevellsinzui: No, I usually take a look at the milestone and then talk to individual developers to work out if I need to do anything15:28
mrevellintellectronica: Well with the in-line help system it will increasingly affect the code base15:28
barrymrevell: +115:28
rockstarI think abentley is right.  I think when it gets to review, we should ask whether or not the needed people were in the loop.15:28
mrevellrockstar: Yeah, I too like abentley's suggestion mainly because it's a way to remind people that I (and beuno) are here if you need us.15:29
sinzuimrevell: have you seen our cover letters for branches? they might be a better start for documentation15:29
rockstarmrevell, not if, WHEN.15:29
mrevellsinzui: I haven't. Could you point me at them?15:29
intellectronicarockstar: but we should try to avoid playing chinese whispers. if you think that the branch you are reviewing touches on the work of beuno or mrevell, why not just invite them to join the review?15:29
* sinzui looks for examples15:30
rockstarmrevell, beuno, both of you play a crucial role in what we're doing.  I think that by the time the review starts, you should already be familiar with this.15:30
barrymrevell, beuno do you have preferred divisions of interest.  by that i mean, what should we ask mrevell about and what should we ask beuno about?15:30
* barry thinks he knows but would like to codify it in a wiki page15:30
rockstarintellectronica, well, if they weren't involved, then yeah, bring them in.  Otherwise, let them get other stuff done.15:30
mrevellbarry: Anything text: UI instruction, in-line help ,documentation, community announcements, marketing-ish stuff, all that I consider my bag.15:30
beunowell, we will probably overlap in some cases. I participate in some UI text as well, so I think that for some things, either is fine15:31
intellectronicaanother thing, is the ui review training. mpt tried to initiate something like this many months ago, but we didn't really follow up on that. i think we should try to resurrect it. beuno?15:31
intellectronicaand maybe do the same with content review training, led by mrevell15:32
mrevellintellectronica: I'm working on a simply UI text checklist at the moment, which might be useful.15:32
beunointellectronica, I'm not 100% sure that I see that working, but I'll give it some thought15:33
barrymrevell, beuno thanks. i will attempt to capture this in a wiki page15:33
mrevellthanks barry and everyone else!15:33
rockstarthanks mrevell and beuno!15:33
barry[ACTION] barry to capture in a wiki page, getting beuno and mrevell involved in ui-related pre-imps and reviews15:34
MootBotACTION received:  barry to capture in a wiki page, getting beuno and mrevell involved in ui-related pre-imps and reviews15:34
barrymrevell: thanks!15:34
barry[TOPIC] anything else?15:34
MootBotNew Topic:  anything else?15:34
barrythat's all i have on the agenda except for the boring stuff.  does anybody have an issue they'd like to bring up?15:35
barrymaybe related to using merge-proposals?15:35
* intellectronica <3 merge proposals15:35
intellectronicaheh15:35
barry:)15:35
* barry likes them, other than the code signing bug :)15:35
barryintellectronica: what do you think so far?15:36
intellectronicai miss diff generation, and the email integration needs a bit of work, but other than that i found using mp intuitive and fun15:36
flacostehow effective is it in replacing PendingReviews?15:37
flacostei haven't used that part15:37
barryflacoste: what's PendingReviews? <wink>15:37
intellectronicaflacoste: very, though the ui could be improved a bit (there's a bug for that)15:37
flacosteseeing what needs to be done, what i need to review, etc.15:37
flacostei have no idea how to find such things15:37
flacostebtw15:37
beunoso, this would be the PendingReviews page: https://code.edge.launchpad.net/launchpad/+activereviews15:37
intellectronicathe problem with this page is that it doesn't show the reviewers15:38
barrythere's also been talk of a person-centric dashboard15:38
intellectronicathe one for the target branch does, but should be formatted more like this page15:38
flacosteyeah you don't know if it's assigned or not15:38
flacosteand when does it get off there?15:39
flacosteonce the branch is merged or once the review has one approve vote?15:39
barryflacoste: when the branch lands i think?15:39
beunoflacoste, when it's marked as merged or approved15:39
flacostebeuno: but that's not the same15:39
beunoexplicitly, not when voting/reviewing15:39
beunoflacoste, it's either of those15:39
beunothere's another page for approved but not merged15:39
flacostea ok15:39
flacostethat's fine then15:39
beunohttps://code.edge.launchpad.net/launchpad/+approvedmerges15:39
beunoboth of those are accesible through the branch listing page, btw: https://code.edge.launchpad.net/launchpad15:40
flacosteand 'Needs fixing' is the equivalent of our old merge-conditional, right?15:40
intellectronicano, i think that's needs-reply15:40
barrybtw, i still notice a few devs still using PendingReviews.  when we do an old skool review, can we encourage them to try m-p for this or their next branch?15:40
flacosteintellectronica: i thought resubmit was needs-reply15:40
intellectronicaoh, maybe15:41
barryneeds fixing == needs-reply15:41
bigjoolsresubmit is scorched-earth I thought?15:41
barrywe don't really have an equivalent for resubmit15:41
flacostebigjools: that would be disapprove15:41
bigjoolsgah!15:41
bigjoolsthis needs to be re-clarified on the ML15:41
flacosteiirc, needs-fixing is what bzr used for merge-conditional15:41
beunoyeah, "tweak"15:42
flacosteand resubmit is bzr needs-reply15:42
barryprojects that don't do the wonderful pre-imps we have use resubmit.  in fact, we may end up using resubmits more after we open source lp15:42
flacostebeuno: a tweak is different15:42
flacosteit's not in the list of vote15:42
beunouhm15:42
flacostethis is so confusing...15:42
beunoit is15:42
* barry looks to abentley 15:42
beunowe just need equivalents to what we have now15:42
flacostethat's why I found i always say the Launchpad status in the comments15:42
beunosocially decide them, move on15:42
flacosteso i think15:42
flacosteapprove = merge-approved15:42
* abentley hasn't worked on the UI in ages.15:42
flacosteneeds-fixing = merge-conditional15:42
flacosteresubmit = needs-reply15:43
flacostedisapprove = you're crazy go do a proper pre-impl call15:43
beunoflacoste, how about needs-fixing == needs reply15:43
flacostebeuno: then what is merge-conditional?15:44
flacostethere is nothing that is close15:44
beunoflacoste, approve + comment?15:44
flacostethat leaves ambiguity15:44
EdwinGrubbsflacoste: merge-conditional doesn't make much as a separate status since you may never go back to the mp to actually approve it.15:44
barrywell, remember that both the review and the mp have 'approved' statuses.  perhaps needs-fixing on the review + approved the m-p == merge-conditional?15:44
flacostewhen the status is needs-fixing, you know you have something to do15:44
flacosteEdwinGrubbs: so?15:44
flacostebarry: that's also confusing15:45
flacostetwo statuses!15:45
barryflacoste: i agree with that15:45
flacostei didn't even think it was possible15:45
EdwinGrubbsflacoste: it seems strange to land a branch in a needs-fixing status.15:45
abentleybarry: No, because a review can have many votes and only one status.15:45
flacosteabentley: right, it makes sense from a data modelling case15:46
beunoEdwinGrubbs, yeah, that was my point15:46
flacosteEdwinGrubbs, beuno: in that case, the split status is good15:46
barryabentley, flacoste agreed on both points, but from a usability pov (imho) it's still confusing15:46
flacostereview is needs-fixing, but the branh is approved15:46
abentleyflacoste: Potentially means people are ignoring that reviewer.15:47
flacosteabentley: ?15:48
* beuno thinks that approve + comment == merge-conditional15:48
beunowhich is what it is15:48
beuno"fix it and land it, don't come back to me"15:48
barryso, our merge-conditional means "i don't want to see this anymore" and includes a trust that the dev will fix the remaining issues15:48
barrythat makes sense to be approved15:48
abentleyflacoste: People get ignored in open source projects all the time.  Perhaps in project foo, three "approve" votes override a "needs-fixing".15:48
* barry notes that we're over time15:49
barryso i think this warrants further discussion an suggest we take it to the ml15:49
flacosteabentley: ok, you're stil arguing why it makes sense to have two statuses!15:49
flacostei ranted and I moved on :-)15:49
flacosteok, do we have a consensus15:50
beunoso, MP +1, but need a little bit discussion on how to use them properly?15:50
flacosteapprove + comment = merge-conditional15:50
flacosteneeds-fixing = needs-reply15:50
barrybeuno: yes, flacoste that would be my preference, yes15:50
beunoflacoste, +1  (that is actually what I meant originally, just jumbled everything)15:51
barryokay, thanks everybody and sorry for going over our time15:51
barry#endmeeting15:51
MootBotMeeting finished at 09:51.15:51
abentleyflacoste: A merge proposal has 1 status and N reviews.15:51
flacosteabentley: one thing that might removes my confusion is how the mp status is related to the N reviews status15:51
flacosteabentley: i guess that it's a manual process15:52
abentleyflacoste: In the code review system, the review outcomes and the status are not linked.  This is because Mark doesn't want to impose policy.15:52
flacosteand that's why in the case when the actual workflow in use is 1-1, it's kind of more work15:52
flacosteabentley: right15:52
flacostewell, i understand where the decision comes from15:52
abentleyflacoste: But note that even in LP reviews, it's not always that.15:52
flacosteright15:52
flacostewith mentoring15:52
abentleyOr with DB patches.15:53
barrytho i wish projects could specify some workflow here so it could be done automatically15:53
flacostehow the permission on the m-p status is controlled?15:53
beunoflacoste, only the owner of the target branch can change it15:53
abentleyflacoste: By manually changing the status.15:53
flacosteok15:53
abentleyflacoste: Sorry, misread.15:54
flacostethen I'd suggest that if the reviewer has permission to change the m-p status, they could set it at the same time than the review vote15:54
flacostethat makes thing a little easier15:54
flacoste'Vote approve and approve the m-p'15:54
abentleyflacoste: I can pass that on to thumper.15:55
beunoflacoste, that sounds good, explicitely saying that it's ready15:56
beunoyou could approve, and say "fix this"15:56
beunoand the submitter can change it to approve once they actually did fix it15:56
beunoso ti's a way of saying everything was addressed15:57
beuno(I didn't mean to write in old english, just getting used to new keyboard)15:57
bigjoolsolde Englishe rockes :)15:58
=== salgado-lunch is now known as salgado
EdwinGrubbssinzui: ping17:40
=== salgado is now known as salgado-afk
=== mthaddon_ is now known as mthaddon

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!