Outreach programs/Lessons learned

We compiled these lessons learned after our first participation at FOSS Outreach Program form Women, in April 2013. Then we updated them in October 2013, after running simultaneously Google Summer of Code 2013 and OPW Round 6. The new lessons are marked with a star.


 * An internship in these programs is a full time job.[[File:Inkscape_icons_draw_star.svg]]
 * Most interns won't be able to combine it with other activities, no matter how optimistic they are.[[File:Inkscape_icons_draw_star.svg]]
 * We had exceptions, but they showed exceptional dedication and skills since the beginning.[[File:Inkscape_icons_draw_star.svg]]
 * Proposals must go through public community review.
 * They must be considered relevant by the related project maintainers.
 * Mentors' judgments are good! But not enough if they come alone.
 * Proposals must consist in one project only.
 * The term is too short for changing projects and/or mentors efficiently.


 * Proposals must specify a clear and measurable outcome.
 * Vague goals are difficult to assess; they are unacceptable.
 * The core tasks shouldn't take more than 50% of the available time.[[File:Inkscape_icons_draw_star.svg]]
 * The other 50% is needed for testing, bugfixing, documentation and deployment.[[File:Inkscape_icons_draw_star.svg]]
 * A good rule: one week of an experienced community contributor equals 3 weeks of an intern.[[File:Inkscape_icons_draw_star.svg]]


 * Proposals shouldn't depend on Wikimedia Foundation's short term priorities.
 * Interns shouldn't be bothered by WMF teams' sudden changes of plans.


 * A first small contribution must be required to all unknown applicants.[[File:Inkscape_icons_draw_star.svg]]
 * Assessing newcomers based on a proposal and a code repository out of context is too tricky.[[File:Inkscape icons draw star.svg]]
 * The first contribution must be related with the type of project proposed.


 * Two mentors are required for each intern.
 * It is a lot less work for each.
 * The second mentor can be really secondary, but must be following the activity just in case.
 * If one mentor drops there is still another one to push until the end.
 * All the better if mentors are also in different locations, forcing good remote collaboration.
 * We cannot assume technical people don't need a basic introduction.
 * Our community is complex, and we use several tools and channels of communication.
 * Many people are not used to open source transparency, and we push it to the extreme.
 * Many people are not used to the wiki way, and for us this is a given.


 * Interns must submit their contributions soon and often.[[File:Inkscape_icons_draw_star.svg]]
 * They must understand that the process, the regular flow, is more important than the final delivery.[[File:Inkscape_icons_draw_star.svg]]
 * Iterating regularly it is easier to find problems sooner, mentor properly and re-plan accordingly.[[File:Inkscape_icons_draw_star.svg]]
 * Awkward problems during the first weeks must be addressed urgently.[[File:Inkscape_icons_draw_star.svg]]
 * Lack of responsiveness, illnesses and multiple technical issues might be symptoms of deeper problems.[[File:Inkscape_icons_draw_star.svg]]
 * Interns reporting these problems must receive immediate and full attention from mentors and org admins.[[File:Inkscape_icons_draw_star.svg]]
 * Teams staying in touch on a daily basis via IRC have more chances to succeed.
 * It really makes a difference, even if they only share a regular time frame idling in the same channel.
 * Interns using bug reporting and code review regularly have more chances of success.[[File:Inkscape_icons_draw_star.svg]]
 * These tools require more discipline and open the project beyond the mentors to the rest of the community.[[File:Inkscape_icons_draw_star.svg]]


 * Monthly reports must be required and plugged to Wikimedia's monthly reports routine.
 * Difficulties coming up with a decent report or delays delivering it are a good symptom of deeper problems.
 * Learning to explain your work is sometimes as important as the work itself.


 * There is no forgiveness at the mid-term evaluation, and interns must know this.[[File:Inkscape_icons_draw_star.svg]]
 * A pattern to avoid: intern underperforms in the first half, but promises to overperform in the second, or later.[[File:Inkscape_icons_draw_star.svg]]
 * The first half is indeed more complicated, but the right approach is to plan the proposal accordingly.[[File:Inkscape_icons_draw_star.svg]]
 * Interns must send a summary of their project at wikitech-l at the end of the program.
 * A blog post is good, but as a complement or "web version" of the mail sent to our main community channel.