Engineering Community Team/Meetings/2014-05-20

ECT IRC meeting at 16:00 UTC via #wikimedia-office ^connect.

Topics:

• Questions & Answers about Google Summer of Code 2014 and FOSS Outreach Program for Women/Round 8. (Qgil)

<qgil> Welcome to the Engineering Community Team monthly meeting
<rohit-dua> hello
<qgil> In fact we meet every Tuesday, but once a month we do it here on IRC.
<Raylton> qgil, thanks
<qgil> The team: https://www.mediawiki.org/wiki/Engineering_Community_Team
<matanya> just to say congratz on tech news milestone
<guillom> matanya: thanks :)
<qgil> andre__, guillom, sumanah and myself are here to discuss and answer questions in our best capacity.
<qgil> The open agenda can be found at https://www.mediawiki.org/wiki/Engineering_Community_Team/Meetings/2014-05-20
<AndChat|517376> muninn-project: good morn/afternoon
<qgil> The only point so far is Questions & Answers about Google Summer of Code 2014 and FOSS Outreach Program for Women/Round 8.
<qgil> If you have any other topics, just let us know and we will find time for them at the end after discussing GSoC/OPW
<qgil> IF YOU ARE HERE FOR THE ECT MEETING RISE YOUR HAND. EOOOO!  o/
<guillom> _o/
<mvolz> o/
<aaron_xiao> _o/
<AndChat|517376> _o/
<BPositive> o/
<kondi> \o/
<bawolff> Hi
<rohit-dua> o/
<fhocutt> o/
<sandaru_> o/
<guillom> Oh  my god, it's full of people!
<ali_king_intern> o/
<andre__> \o/ I think.
<muninn-project> o/
<ralgis> o/
<sumanah> o/
<kunalg> o/
<tonythomas> o/
<AndChat|517376> =jlschatz my nick is taken o_0
<andrewbogott> o/
<Raylton> o/
* Krenair is lurking IRC, as always
<discoveranjali> o/
<matanya> 139 people basically
<thepwnco> o/
* Raylton feels a IRC party 
<tonythomas> great !
* HaithamS has quit (Remote host closed the connection)
<guillom> I think this is a record number of people actually here, not just idling, for an ECT meeting :)
<qgil> This is indeed great. We seem to have a critical mass of GSoC and OPW interns and mentors.
<qgil> For those that couldn't make it, logs will be available at https://www.mediawiki.org/wiki/Engineering_Community_Team/Meetings/2014-05-20
<andre__> Yeah, I'm happy to see so many people here! Welcome & thanks for your help in making Wikimedia better for the world!
<rohit-dua> :-)
<qgil> Good. Anybody landing later can just say hi. Let's move on.
<qgil> About GSoC and OPW
<qgil> https://www.mediawiki.org/wiki/Google_Summer_of_Code_2014
<qgil> https://www.mediawiki.org/wiki/FOSS_Outreach_Program_for_Women/Round_8
<qgil> I'm the org admin for both programs, hoping that most of my work has been already done, willing to just sit back and see how you complete 23 projects in the next three months.  :)
<qgil> Since yesterday, all interns are supposed to be working in their projects, well in sync with mentors, after a successful community bonding period.
<qgil> From a program coordination point of view, all you are expected to do is regular reporting, as explained in the wiki pages.
<qgil> So the first question is for you: how was the community bonding period? Is anybody still having misc problems impeding them to start working?
<sumanah> https://www.mediawiki.org/wiki/Evaluating_and_Improving_MediaWiki_web_API_client_libraries I have already started enjoying mentoring the project "Evaluating and Improving MediaWiki web API client libraries" by fhocutt - but I think she has had a bit of trouble with Linux wireless drivers! :/
<qgil> (this is a biased question, since those having lots of problem perhaps didn't even know about this IRC meeting...)
<tonythomas> It was great for me. No official community-bonding anyway, but was around for some time
<jlschatz_intern> I'm fighting IRC quite a bit (as you can see).
<sumanah> it slowed her down but she still got nearly everything done that she planned on doing during her community bonding period
<fhocutt> I'm also still getting used to IRC
<rohit-dua> well i have bonding with one of my mentors(Tpt) but others(aubrey and Yann) not so quite.
<mvolz> I've had a lot of communication already today and yesterday
<muninn-project> I'm happy with how things are going with jlschatz_intern up to this point, the support network is pretty solid.
<BPositive> qgil, The bonding actually started 3 months ago ;) But myself, Nikerabbit and Nemo_bis are having daily 15 minute meetups on #mediawiki-i18n for the past three weeks
<mvolz> I was a little surprised to discover yesterday I had two new mentors :)
<thepwnco> I'm actually not starting until the first week of June (my mentor is aware and this was outlined in my proposal) but have had communication and sorted out some reporting tools already
<BPositive> and we have something up on gerrit too :)
<mvolz> which I'm very happy for as my project has changed technologies.
<ali_king_intern> I'm in the same building as one of my mentors at the moment, so communication is good :)
<discoveranjali> The community bonding period for me went awesome. I am working on 'Wikidata Outreach' project mentored by Lydia Pintscher. She's extremely helpful and friendly.....I bonded well to community with her help :)
<Raylton>  qgil we have made progress https://meta.wikimedia.org/wiki/Book_management_2014, but I feel that the time zones prevents us from communicating as much as we should
<mvolz> ali_king_intern: nice!
<tonythomas> I had problems with slow SSH into the bastion servers, but Jeff and I got it fixed with mosh ! great alternative to those away from the wikitech labs servers and experiencing slow SSH
<rohit-dua> i started the frontend for my project. But the core i'll be starting after a week / university exams..
<qgil> Raylton, timezone differences are the norm more than the exception, for all of us. Managng asynchronous communication is essential in free software projects.
<wctaiwan> I'm in touch with my mentors via IRC and I've been looking at the code and making minor patches.
<tonythomas> rohit-dua:  university exams - same here ! gets over in two days for me.
<sandaru_> I am okay with the project so far and the communication is good with my mentor andrewbogott
* andrewbogott waves
* Micru waves
<rohit-dua> tonythomas: lucky you. ;-)
<kunalg> I started with some basic idea for the project and exploring various features in mediaiwiki. Submitted two reports for work.
<rillke> tonythomas, toolserver was much faster for European users; but mosh works, yes
<Micru> hi qgil, thanks for your answer!
<tonythomas> rillke: specially if you are in India - mosh is great !
<fhocutt> I'm glad to have 2 people assisting mentors so we can cover more languages (esp ones I'm not familiar with yet)
<kondi> Spent most of the time documenting the requirements and reading. Apart from daily chats, I had a meeting with my mentor. afk.
<mutante> no wonder, since toolserver hardware is in Amsterdam
<Raylton> qgil, i know ^^
<discoveranjali> I am in good pace with my work since the start of May ..... planned to few outreach ideas along with my mentor and shall soon be finalizing and publishing them !
<Raylton> qgil, thanks
<rohit-dua> qgil, reports should be submitted weekly or monthly?
<tonythomas> mutante:  It used to be almost 1 sec delay between keystrokes :\
<qgil> rohit-dua, we will talk about reports as soon as we are done with the community bonding discussion
<ali_king_intern> currently preparing a presentation for SMWCon on Thursday - also a great opportunity to talk to useful people
<qgil> fyi, Micru is referring to this reply, which is relevant to GSoC/OPW: http://lists.wikimedia.org/pipermail/wikimedia-l/2014-May/071856.html
<aaron_xiao> pretty good for the bonding time. we discuss in mailing list wikizh-l, not only the mentor, but also other guys
<Micru> qgil, do you think it is convenient for all GsoC projects to use Phabricator?
<qgil> Micru, letś talk about this after the reports.  :)
<qgil> The first report is about the community bonding period.
<Micru> ok, ok, qgil :)
<qgil> You have all learned something, you have made first decisions as a team, you have found some expected and unexpected obstacles...
<qgil> Please reflect the most important aspects in a short report. This will give you some practice reportin.  :)
<qgil> Any questions about this first report?
<sandaru_> what would be the approximate word count of this?
<qgil> Copying from https://www.mediawiki.org/wiki/Google_Summer_of_Code_2014#Status :
<qgil> community bonding report including links to
<qgil> minimum viable product and goals
<qgil> communication plan
<qgil> lessons learned since 21 April
<fhocutt> where should we post them?
<qgil> sandaru_, reports are as short as possible, providing important details and links
<discoveranjali> Any preferred format to be followed for the report ?
<qgil> Every time you write your report you have to think hat there are 22 more interns doing the same, and this is only two programs among the many we have around
<muninn-project> roger
<qgil> Also in the wiki we are identifying good practices (well, just one so far, but mentors and other vets are welcome to add more examples)
<qgil> The example provided: https://www.mediawiki.org/wiki/User:Mariapacana/OPW_Progress_Report
<sandaru_> Thanks qgil
<mvolz> Ok so FOSS OPW interns should follow the same format as GSoc i.e. weekly reports?
<qgil> Create a subpage under your project wiki page and start reporting there, creating new sections for new reports
<tonythomas> qgil: ok
<qgil> We have seen all kinds of frequency used, from monthly to daily. It is a good idea to default to weekly reports.
<qgil> mvolz, https://www.mediawiki.org/wiki/FOSS_Outreach_Program_for_Women/Round_8#Status contains exactly the same text, transcluded
<qgil> We want to align GSoC and OPW processes and standards as much as possible
<qgil> Why weekly? Because you can miss one week and itś not a big problem, but if you miss a second report it has been "only "14 days missing.
<qgil> Previously we were defaulting to monthly reports, but then we found about serious problems really late (for a project that is supposed to last about 3 months only)
<qgil> More questions about reporting? More opinions from mentors, ECT colleagues...?
<ali_king_intern> how should this relate to the (minimum) fortnightly blog posts, if at all?
<guillom> I think twice a month is a good rhythm, more is welcome
<matanya2> e.g watch list grouping project
<Raylton> qgil. I think wikimedia should require reports "every few days"
<jlschatz> matanya2: what's a watch list grouping project?
<Raylton> i do that with deepali and molly... good results
<matanya2> previous gsoc project that died
<qgil> ali_king_intern, OPW have this requirement for fortnightly blog posts. At least from the Wikimedia point of view, you could paste your two weekly reports preceded by an intro, and be good.
<jlschatz> matanya2: thanks
<sumanah> Raylton: can you point to a sample report? am I right in inferring that each one was maybe a paragraph long?
<qgil> guillom, Raylton "Wikimedia" is suggesting weekly, but every team can decide the way of woerking that fits best for them.
<guillom> sounds good to me :)
<qgil> We only want a simple communication plan agreed with the mentors, no sttress, and no ugly surprises.  :)
<Raylton> sumanah, https://meta.wikimedia.org/wiki/Book_management_2013/Progress#Weekly_reports
<qgil> Raylton, sumanah, other,  you are encouraged to link to more god examples of reports next to the example of Maria Pacana at the GSoC page.
<qgil> Anything else about reporting? Have I missed any questions?
<jlschatz> qgil: I have an OT Q re: ugly surprises, will there be time later?
<matanya2> gnome gsoc reports are good
<Raylton> qgil, yes... I have problems with google-melange
<apsdehal> Hi everyone, where can we host our server side scripts, wikimedia labs?
<qgil> jlschatz, the ugliest surprise (imho) is when everybody thinks that an intern is doing ok, just having some temporary difficulties, until you realize that the project has been stalled and about to fail
<qgil> all because having too much patience with silence, or with misc arguments avoiding some core problem
<Raylton> qgil, I sent an email to you but got no answer
<rillke> apsdehal, gerrit or github ?
<qgil> Regular reporting is not the solution for this problem, but at least helps detecting the symptoms earlier and better.
<rillke> (gerrit-wm)
<apsdehal> No I want to run, actually I have to create an api for wikimedia login
<jlschatz> qgil: yes, that would be bad :). Very frequent reporting sounds really helpful for that. My Q was about the "if funding comes in" portion of our OPW contracts.
<qgil> Raylton, the one about you not being officially a mentor? In my ToDo list, no worries.
<matanya2> apsdehal: yes
<apsdehal> To which I can redirect my client side app towards that api for login
<rohit-dua> what about phabricator. shall it be used for all projects?
<qgil> jlschatz, I'm not sure I understand the link between ugly surprises and funding. Can you explain, please?
<mvolz> jlschatz:
<mvolz> whoops.
<apsdehal> Actually software I am building upon already has openid login
<apsdehal> But wikimedia doesn't supports it
<qgil> apsdehal, can you leave discussions about your project for later, please?
<mvolz> jlschatz: are you referring to gnomes issues with cash flow problems for the last round?
<jlschatz> qgil: the contract says that if funding falls through, interns won't receive payments even if they're successful in their projects
<apsdehal> qgil: Yes, sorry for that
<andre__> apsdehal: spontaneously I'd say: Wikimedia Labs.
<Raylton> qgil, thanks. please answer  before the midterm.
<jlschatz> mvolz: i think the change in the contract language was a result of their cash flow issue (i read about it online, didn't hear from Gnome specifically on it)
<qgil> jlschatz, Wikimedia pays its bills as much as Google.  :)  You shouldn't worry about funding.
<jlschatz> qgil: :) thanks
<qgil> Ok, anything else about reporting before moving to the question about Phabricator?
<thepwnco> yes - when should community reports be submitted? My guess is as soon as possible...
<rillke> a deadline is always welcome
<tonythomas> rillke: you just need to update it as soon as you complete a milestone right ? why deadlines ?
<qgil> thepwnco, the community bonding report can be submitted... soon.  Let's say this week, since  you are required to submit your first actual report about the project by 30 May.
<fhocutt> tonythomas, deadlines help some of us focus
<Raylton> qgil, a blog post is ok for that?
<qgil> We have just a few dates defined during the program, some of them set by the program organizers aka Google & GNOME. They are useful as sync points.
<tonythomas> qgil:  submitting == updating your report wiki page right ?
<qgil> Raylton, for what?
<qgil> tonythomas, yes.
<tonythomas> qgil: cool then
<Raylton> qgil,  community bonding report
<qgil> We recommend you to submit brief reports in a wiki subpage (see the example above). If you want to write blog post, send updates to mailing lists, etc, you can also do it.
<rillke> should we touch https://www.mediawiki.org/wiki/Google_Summer_of_Code_2014 again or leave it as it is ?
<rillke> - for listing reports etc.
<qgil> rillke, it is useful to keep your row in that table up to date. It gives a good view of the status of the whole program.
<qgil> rillke, no need to list every weekly report, but main milestones.
<qgil> e.g. mid-term evaluations
<qgil> Reporting ok?  :)
<rohit-dua> :)
<qgil> (I will try to capture the usual questions and document the answers in the GSoC / OPW wiki pages.
<qgil> The question about Phabricator
<qgil> The bottom line here is that you need to define the way you want to work.
<qgil> The wiki project page is a must, it needs to be updated reflecting always the current plan + the subpage with reporting.
<qgil> Then, about the tasks, we have been using Bugzilla as a way to define tasks, blockers, etc, for coding projects.
<andre__> Is it broadly known here what "Phabricator" is, when it comes to our infrastructure? (I wonder if I missed an email I'm not aware of)
<andre__> (In short: It will replace Bugzilla at some point.)
<qgil> Most of your projects have a central report in Bugzilla, so it is easy to create blockers for specific tasks, bugs, etc.
<qgil> andre__, I'm getting there.  :)
<qgil> And then most of your projects also have a related code repository, by default in Gerrit.
<qgil> We are just in the middle of a transition to go from these various tools to Phabricator (keeping MediaWiki for documentation)
<qgil> https://www.mediawiki.org/wiki/Phabricator
<qgil> In this context, you may want to consider the possibility of using/testing Phabricator for your project.
<qgil> ... which is the advice I gave to Micru earlier today at http://lists.wikimedia.org/pipermail/wikimedia-l/2014-May/071856.html
<qgil> Phabricator is useful to organize tasks, and you could use our instance at http://fab.wmflabs.org/ already now
<muninn-project> ok
<rillke> And it reliably works :)
<qgil> For instance, this is what rillke is doing at http://fab.wmflabs.org/project/view/26/
<qgil> For code review... it might be premature, although it depends on how brave and how much are you willing to be an alphatester.
<qgil> So you don't have to use Phabricator, and the default keeps being Bugzilla, but if you want to try and help testing/learning about this tool, you are welcome.
<qgil> Is it clear?
<Raylton> qgil i need to leave. i'll see the logs and ask some question by email. ok?
<qgil> ok Raylton 
<Raylton> thanks
<rohit-dua> qgil, where should i host server side scripts(like python-bot scripts)?
<qgil> rohit-dua, your mentors should know, but I guess the answer is Wikimedia Labs
<andre__> rohit-dua: would Wikimedia Labs work for this?
<qgil> https://www.mediawiki.org/wiki/Wikimedia_Labs
<rohit-dua> sndre__, yes. i meant where should i publish the code for the bot for review process
<matanya2> gerrit
<qgil> rohit-dua, please agree this with your mentors
<rohit-dua> qgil, ok :)
<qgil> Gerrit is the default option, yes.
<sumanah> qgil: let me make sure: https://www.mediawiki.org/wiki/Google_Summer_of_Code_2014#Status "community bonding report including links to: * minimum viable product and goals * communication plan * lessons learned since 21 April" -- can you please explain what you mean by "minimum viable product"? Because I think you are saying "DESCRIPTION of what the mentee WILL achieve, at minimum, within the next 3 months"
<qgil> More questions?
<qgil> About minimum viable product
<jlschatz> +1 for sumanah's Q
<qgil> 1 min... searching
<sumanah> honestly I think we should either remove that jargon entirely and leave "goal" (which everyone understands) or explain better.
<qgil> See https://www.mediawiki.org/wiki/Mentorship_programs/Selection_process
<fhocutt> also for sumanah's question, if that's for the entire project is there not a section for "things achieved since 21 April"?
<mvolz> I find the MVP concept very useful although it's true that everyone might not understand it.
<fhocutt> or is that just "lessons learned"?
<qgil> "A good team must work on a good plan. A good plan is expected to define a minimum viable product (the content of your first testable release) and build the rest of features on top of it."
<sumanah> in most cases, the goals/mvp description that would belong that initial "community bonding report" is what the mentee wrote up in their Deliverables section of their initial proposal, I think
<sumanah> qgil: that's still unclear and confusing, because that sentence you just quoted conflates the planning and the building.
<wctaiwan> ^ that's what I thought as well. I'd pretty much just be saying "see [[section]] in proposal"
<fhocutt> mvolz: it's also less relevant to projects like mine that focus on standards and documentation
<qgil> sumanah, yes yes, letś clarify. Still searching references.http://en.wikipedia.org/wiki/Minimum_viable_product
<mvolz> That's true; although my project has changed pretty substantially since then.
<mvolz> fhocutt: good point
<qgil> The problem we want to solve is:
<qgil> projects that at the end of the program cannot deliver a single thing
<fhocutt> I understand the terminology, I'm just not going to have a testable release
<qgil> because they aimed to do everything but finished nothing
<sumanah> Right
<qgil> this is why already during the selection process we have encouraged students and mentors to define a minimum viable product, a first minimal release to build upon
<sumanah> again, qgil, when you say "to build upon" it
<sumanah> it gets confusing
<mvolz> is there a sample community bonding report?
<mvolz> this is new to this round, correct?
<qgil> Even in the case of documentation you may want to define a focus in one areas as opposed to try to push all "chapters"at once
<sumanah> yes
<sumanah> which my mentee has already done, as she worked out the list of deliverables she would be delivering
<qgil> sumanah, "release soon, release often"
<sumanah> qgil: yes. I am objecting to your wording as confusing.
<qgil> get something out that someone else can look at (a minimum viable product, a prototype...) and then continue improving it
<fhocutt> this makes sense as a concept but I still don't know what I'm supposed to put in the report.
<sumanah> fhocutt: My advice: just copy your list of deliverables (a.k.a. goals) that you aim to achieve by the end of the summer.
<qgil> please propose a better wording
<wctaiwan> do we need to repeat what our minimum viable product is if we've already defined it in our proposal?
<qgil> sumanah, I still think it is useful to define your first "publication", that should come before the mid-term evaluation
<qgil> your initial focus
<sumanah> fhocutt: If we find that you have time and ability, then you'll be able to do more stuff beyond that -- file more bugs, polish more documents, and so on.
<sumanah> ok, then, fhocutt, copy the list of the things you'll be achieving in the first 6 weeks. you have your deliverables set up by week already so that should be fairly straightforward
<qgil> Looking at previosu projects, those that didn't have anything to show before the mid-term struggled during the second half.
<fhocutt> thanks, sumanah, will do
<sumanah> cool
<siebrand> Have to go. Thanks for this meeting, qgil. Very useful IMO.
<qgil> wctaiwan, you don't need to details you plans in the community bonding report, just link to the relevant places.
<wctaiwan> okay, thanks.
<qgil> siebrand, thanks!
<thepwnco> also have to run. Thanks for this. Happy interning all!
<qgil> sumanah, I will try to clarify the wording. Nobody had complained until now.  :)
<qgil> 2 minutes
<sumanah> I changed https://www.mediawiki.org/wiki/Google_Summer_of_Code_2014#Status to ask for "goals for the first half of the internship"
<qgil> sumanah, good.
<qgil> Ok, it looks that this is it. Thank you everybody!