Wikimedia Hackathon 2017/Mentoring Program

For this year’s Hackathon we will be implementing a mentoring program for newcomers to our movement. The mentoring program is a new approach that we are trying out for the first time, where we were looking for Wikimedians who will be at the hackathon exclusively as mentors. They will come up with newcomer-friendly projects and ideas and, during the whole weekend, work with groups of about two to six newcomers, to help them with the whole onboarding process, and make their way into the great Wikimedia tech community as easy and as much fun as possible. The focus is to welcome more newcomers into the community, by introducing them to the different aspects of working with MediaWiki, and help them achieve their own first steps during the hackathon weekend. Additionally, we want to create a welcoming social atmosphere, so we can further diversity and growth in our community.

What does it mean to be a mentor?
Since the mentoring program is something new this year - much more guided and focused than previous initiatives (like e.g. the buddy system) - we want to make sure that everyone is on the same page.

Being a mentor means:

You will be at the hackathon exclusively as a mentor! You will create projects that are newbie-friendly and you will work on them together with the newcomers  for the whole weekend. You will not get as much done as you would on your own, but you will contribute an incredible amount of value to the community by sharing your knowledge and helping the movement grow.
 * Before the hackathon, everyone will come up with newcomer friendly projects, broken into small and large, easy to accomplish tasks. Mentors, like all other participants, can contribute their ideas for sessions, skill share and projects in advance on Phabricator (see: "Contribute to the Program Before the Hackathon" on the Program-page). Additionally, mentors will present their projects in newcomer-friendly language here on this page down below.


 * Before the hackathon, we will keep sending the mentors emails with updates on the mentoring program as we will develop it together – since this is a first time for all of us, we really value your feedback and contributions!
 * At the opening ceremony, the mentoring program and the mentoring team (as a group, not personally) will be introduced and greeted with a round of applause.
 * After the opening ceremony, mentors and newcomers will meet in person and get to know each other, and both mentors as well as newcomers can decide with whom, and on which project they want to work together for the weekend.
 * And, as a special thank you: mentors will get some mentors-only goodies, and the commitment to teach others will be much, much appreciated.


 * Mentors will work with newcomers throughout the three days, but they will not be left alone: We will have regular mentor-meetings during the weekend, to asses the situation, identify potential problems in advance and provide help and exchange within the mentoring team as well as the hackathon staff. Whatever you need during the weekend, you can count on the hackathon staff team to help you out as best as we possibly can!

Welcoming newcomers into the movement is our goal...
This program will give newcomers the chance to dive into the Wikimedia movement and try out projects that are designed in a way that will give them the chance to hack on something that can be accomplished on that weekend, with the support of experienced Wikimedians as their mentors. While hacking, the newcomers can get to know the Wikimedia movement and see what impact they can have. We would like to create an event which will offer newcomers the opportunity to engage closely with Wikimedia projects. Pre-assigned hacking groups for newcomers will be kept small, with only four to six participants per project. It will be a unique chance for newcomers to get to know some of the coolest projects and coders out there and become part of the Wikimedia community!

... and the mentoring program is just one of many ways to do it.
While we are especially thankful for everyone who signed up to be a mentor exclusively, we also need people who do not want to take up this pre-defined role, but instead want to keep the flexibility that makes up such a great part of Wikimedia Hackathons. Everyone can give sessions tailored to newcomers and share their skills in whichever way they choose during the hackathon. (See Wikimedia Hackathon 2017 Program for details on how to do this.) It is very important to us, to provide the space and flexibility for others to help and get involved in a less formalized way.

Newcomers
'''I am a newcomer and would like to join the mentoring program! What should I do?'''
 * 1) In the registration form, we offered everyone the option to indicate that they are new, and want to join the mentoring program. If you did this, you will automatically be on our list of newcomers and will receive an email with further information! If you did not register as new, but want to join the program, too, please email to hackathon@wikimedia.at and let us know!
 * 2) Read this page to get familiar with the mentoring program idea, and get to know your mentors.
 * 3) Check out our Resources for Newcomers & Prepare for the Wikimedia Hackathon-section on this page, to prepare yourself and your tech!

General sources for MediaWiki

 * Starter’s Guide: How to become a MediaWiki Hacker
 * here on MediaWiki.org, the main website for the software itself…
 * … and its extensions manuals

Resources from MediaWiki pre-hackathon workshops in Vienna

 * Tutorial for installing MediaWiki on a server, by jackie: wmws.tantemalkah.at
 * Installing MediaWiki using VirtualBox, by Tobias: Download PDF
 * Quick Start in MediaWiki System Administration, by Alex: Download PDF

Prepare for the Wikimedia Hackathon

 * Have a look at the Hackathon FAQs to get an idea of what the event is going to be like: Hackathon-FAQs on mediawiki.org
 * Read the Starter’s Guide How to become a MediaWiki Hacker
 * Create your account on Phabricator. During the hackathon, we use the web-based, software development collaboration tool suite Phabricator. Here’s how to get started: mediawiki.org/wiki/Phabricator/Help
 * Set up your laptop: Follow the instructions on mediawiki.org/wiki/Hackathon/Laptop_setup to get your development environment setup
 * Join our Telegram Group Chat: t.me/wmhack
 * Join our IRC Channel: #wmhack

= Mentors =

Your Mentors in Vienna 2017
In the registration for the hackathon, everyone was asked if they wanted to volunteer as a mentor. Everyone who answered positively got an email, in which the details and responsibilities of this year's new mentoring program were explained. The people who then opted in for a second time, are now our mentors for this year's hackathon!

Matching Mentors and Newcomers
Mentors and newcomers will match themselves, in person at the first day of the hackathon, after everyone gets to know each other.

After the opening ceremony on Friday, all mentors and newcomers will go for a joint mentoring program session to the breakout room Wiaschtl to meet and get acquainted.

The organisers will prepare the session, in which everyone will have a chance to introduce themselves. The mentors will quickly pitch the projects they have prepared and/ or the areas of expertise which they can offer for the newcomers. Newcomers will separate into groups and find their matching mentors, according to their likes and interests.

Point of contact
= Mentoring Guide = ''As a mentor, you are the heart of the initiative for newcomers in the movement. In order to make the mentoring program work as best as we can, we are establishing this guide. We will need all of your feedback and learnings to improve the program in general, and this guide in particular – we are excited to do this with you. The goal of this guide is to help you being well prepared, and to give you options and inspirations to draw from.''

''This guide is focused on creating a friendly and open environment for learners of all sorts – but also for you, the mentors, yourselves. This guide strives to help with making everyone feel comfortable, to have a pleasant learning and mentoring experience, as well as having a great weekend together.''

Building on lessons learned

With this guide, we are building on lessons learned from previous newcomer-initiatives, mainly the buddy system, which was first introduced at the Wikimedia Hackathon 2015. While the idea to help newcomers was appreciated, the process felt a forced for some, while others were a bit lost. Suggestions for improvements called for an improved pairing process (e.g. based on projects, not people, and giving people the option to switch), guidelines for best practices and managing expectations in advance. With this guide, we are trying to make due on that. (Read the full lessons learned from Lyon 2015.)

Sources for this guide

This mentoring guide is built from the Open Tech School coaching guide (CC BY-SA 3.0 Open Tech School), which itself roots in the RailsBridge teaching style (CC BY 3.0 RailsBridge). Additionally, we draw from the Django Girls Coaching Manual (CC BY-SA 4.0 Django Girls), the Rails Girls Guide for Coaches (CC BY-SA 3.0 Rails Girls) and the Jugend hackt Handbuch (CC BY 4.0 Paula Glaser, Maria Reimer, Daniel Seitz for OKF DE and mediale pfade.org). All of these links are excellent sources if you want to dig deeper into the art of mentoring.

Mentoring isn't teaching…

in the sense that mentors are not standing in front and teaching a class.

Mentors... Creating a friendly environment
 * Stand by on the sidelines
 * Are right there when needed
 * Focus on the learners
 * Have sympathy for their (in-)abilities
 * Encourage learners to go further through positive motivation
 * And ensure they have fun doing it.

Atmosphere Encouragement Questions Questions are good! Responding to questions
 * Smile
 * Make eye contact
 * Admit when you don't know something
 * Be kind and friendly
 * Use their name (on the name tags)
 * Tell learners it's ok to make mistakes
 * And to take breaks when it gets frustrating
 * Assume everyone you're mentoring has zero knowledge but infinite intelligence
 * Use normal language instead of slang
 * Make sure the learner understood what you said...
 * ...and explain it again differently if that's not the case
 * Encourage learners to play around on their own
 * Whatever they do is great!
 * Look around to see if someone else might be having trouble
 * They might just be afraid to ask
 * Come by once in awhile and ask: “Hey, how is it going? Anything I can help you with?”
 * This is a very powerful tool: It helps shy learners, builds rapport and increases engagement.
 * Another trick: Sit next to them and chat about what they are doing.
 * Get people comfortable asking questions
 * Emphasize that there is no such thing as "dumb" questions
 * Ask if learners have any questions
 * Give other learners the chance to try to answer that question
 * Coding is collaboration — make sure learners understand that

Chances are, there is a specific question when the learner asks you to help them. How do you respond? Pacing Be encouraging Don'ts
 * Positively:
 * "I’m glad you asked that."
 * "What an interesting question!"
 * "Great question!"
 * "Hm, I'm not sure... Let's look in the Internet/ask someone else."
 * If in doubt: blame the material, never the learner.
 * Their interpretation of the material might be as good as ours!
 * This is not about you, but about the learner. We go at their pace.
 * Everyone learns at their own pace. That's a good thing!
 * Talk sssssslllllloooooowwwwwwllllllyyyyyyyy.
 * Wait much longer than you feel is comfortable for questions/comments (count to 10 in your head)
 * Don't accept any learner saying they are too whatever to do it, answer that they can do it.
 * Congratulate people on their achievements, take some time to let them show them to you.
 * If people get off the path but have fun, encourage them to go on.
 * Encourage learners to show their work to others: invite them to present at the showcase at the end, or to show their stuff to other participants during the event. Tell them twice. Or three times. Whatever it takes.

a few things we are not doing Their keyboard – it is made of lava! We do not discuss programming languages
 * We do not hit on anyone or make sexually suggestive remarks
 * We do not roll our eyes or laugh at questions
 * We do not use the time to advertise our own companies/jobs/ourselves
 * We do not pick on or make fun of anyone or anything
 * We do not debate which programming language, methods or technologies are "better"
 * We do not touch their keyboard
 * Learners are going to drift away when you take over their keyboard.
 * Don't touch it.
 * If you absolutely, ultimately must type something on their computer — chances are you don't —, ask whether that is okay with them.
 * And explain what you are doing.

Doing so confuses learners. In the tech community we have some strong opinions and our ways to express them, but for people new to it, this can quickly look like a huge fight. We do not fight each other!

“We are here to mentor you in this programming language/method/technology and that is the focus for this event.”

Thank you for being a mentor at the Wikimedia Hackathon!