Outreachy/Mentors

Overview edit

As an Outreachy mentor, you engage potential candidates in the application period between March–April (summer round) and October–November (winter round) and help them make small contributions to your project. You work more closely with the accepted candidates during the internship period between May– August (summer round) and December–March (winter round). It is a great mentoring opportunity to introduce newcomers to open source through coding and non-coding (in the area of design, documentation, research, outreach, translation, marketing, etc.) projects, make progress on new ideas that otherwise may be of a less priority to you, and in the overall process improve your professional development skills. Our participation in Outreachy also helps us understand new contributors experiences and help make improvements to our guidelines and processes around attracting and retaining them.

If you are considering to become a mentor, learn more below.

Responsibilities edit

 Before the program edit

  1. Read the Outreachy mentors manual to get an overview of your responsibilities.
  2. See a list of past projects to gather new ideas. Note: Project should require an experienced developer ~15 days and a newcomer ~3 months to complete. Ideally, the project has no tight deadlines, a moderate learning curve, and fewer dependencies on Wikimedia's core infrastructure. Projects addressing the needs of a language community are most welcome.
  3. Request to be added to the restricted Phabricator group Outreachy Mentors. Once you have been added, create a task on Phabricator about your project with the tag Outreachy-Round-XX (XX being the ongoing round number) using the template given at outreach-programs-project. Remember to restrict access to the project task to Outreachy Mentors group. This step is important as the recent changes in the Outreachy application process requires keeping the featured tasks hidden from the applicants until the application period begins.
  4. Create an account and sign up as a mentor in the Outreachy administration system following the instructions here. After notifying the program administrator of the project, upload the proposal on the Outreachy website.
  5. Subscribe to the Outreachy mentors mailing list to receive announcements, program updates and applicant queries. Remember to set a filter for lists.outreachy.org to ensure it ends up in your personal inbox.
  6. Talk to interested candidates. Share with them project details, goals and some ideas for implementation.
  7. Point them to self-contained, easy and newcomer-friendly microtasks listed in the task description. See example: T205199, T318921.
  8. Communicate your preferred medium of communication and active hours to applicants. We suggest using public forums like Phabricator and Zulip instead of private email threads.
  9. Review proposals on Phabricator and give feedback (ideally within one week of any request-for-review raised by applicants).
  10. Review Wikimedia applications for your project on the Outreachy website and indicate your selection. Use the following selection process tips.
  11. Inform organization administrator about your decision.

During the program edit

  1. Set development & communication plans with your mentee. Aim to get a Minimum viable product (MVP) out the door and fine-tune plans as needed. Set aside time in your schedule for a weekly video check-in meeting with your mentee to help them stay on track.
  2. Help host new coding projects developed during the program on Wikimedia GitLab; Wikimedia is actively migrating all its repositories from Gerrit To GitLab. Be it any code hosting platform, ensure the code repository is public and available under an official global or local technical community account. This will not only give interns' contributions more visibility that they can add to their portfolio, but it will also be easier to maintain the project or bring more contributions to it easily in the future. Similarly, for documentation projects, ensure that no content remains on user pages before the internship ends.
  3. Encourage your mentee to submit new changes (for code, documentation, etc.) for review often, ideally every alternate day. Spend some time every few days reviewing their work and giving feedback.
  4. Encourage your mentee to submit bi-weekly reports and share project updates frequently on relevant wiki pages, Phabricator tasks, Zulip channels, etc.
  5. Involve your mentee in a local or global wiki community by introducing them to various projects & initiatives, how to get involved, connecting, and helping build relationships with fellow interns, staff and community members, etc.
  6. Before the program ends, make sure to document any open tasks, file known bugs or merge leftover code.
  7. Submit timely project evaluations to organization administrators. Mentors can request an extension for up to five weeks if the intern cannot work full-time (30 hrs per week) due to personal circumstances. But, if an intern has already put in the required hours, mentors cannot request an extension solely to complete pending work on the project.
  8. Participate in Outreachy chats organized by the program organizers, and share your perspectives and experiences with mentors from other open source organizations.

After the program edit

  1. Share project outcomes in relevant communication channels (mailing lists, social media, chat channels, etc.)
  2. Share any lessons learned or ideas for improving outreach program documentation with organization administrators
  3. Recommend the next steps with your mentee for staying involved as a contributor in the project or community.

Selection Process Tips edit

  1. Seek long-term contributors, not just new features. It probably takes more time to mentor a project than to complete it yourself.
  2. Choose the best candidate, not the one that arrived first.
  3. Don't choose a candidate based only on a convincing proposal and past experiences. They must complete our recommended program guidelines.
  4. Be transparent in your communications with contributors and treat them all fairly.
  5. Don't share any information about final results with your candidates before the official announcements. This also means:
    • Do not assign a specific Phabricator project, or its dependencies to any potential candidates before the official announcement.
    • Don't make up your mind on a candidate before the submission deadline. Allow all potential candidates to submit proposals for the project until the official deadline.
  6. Do not share a single project idea between two candidates. Try breaking it up into individual non-overlapping modules for better evaluation of individual efforts.
  7. Look for feedback and endorsements on the proposal from the community members
  8. It's recommended to interview your candidate via an online medium.
  9. Ensure that participant would be able to put the number of hours as expected of them from the outreach program.
  10. Score your mentee and report to the organization admins. You could use the system below to rank them on a 1-5 scale (adapted from the Outreachy program):
    • 5 = amazing applicant, could become a maintainer on completing the program, made extensive contributions of high quality
    • 4 = strong applicant, will certainly do a good job, made substantial contributions of high quality (> ~50 lines of code or equivalent)
    • 3 = good applicant, but is somewhat inexperienced
    • 2 = is unlikely to do a good job
    • 1 = not a good candidate
    • Additional free software experience indicator(s)
      • + = enthusiast based on past actions (e.g. has a blog, has been to conferences, has an active GitHub account, or contributed to free software for some time)
      • 0 = proficient user of free software
      • - = no experience or very new to free software
  11. In case of a GSOC/Outreachy overlap -- consider a female GSoC applicant for Outreachy only if they are best or only candidate for a project that is not receiving a GSOC slot.
  12. If two applicants are ranked equally based on their contributions during the application phase, only then, consider their prior contributions to make a final decision. We strongly discourage giving priority to someone with prior contributions and fewer during the application phase over another candidate with more contributions during the application phase.

Resources edit