Hackathons/Participants - MediaWiki
Jump to content
From mediawiki.org
(Redirected from Hackathon 101)
For further details and specifics, see Hackathons.
An overview of the Wikimedia Hackathon 2016.

An FAQ about hackathons for (future) participants. (Updates always ongoing, help appreciated!)

What is a Hackathon?

[edit]

A hackathon is an event, typically lasting several days, in which a large number of people meet to engage in collaborative computer programming.

More specifically, Wikimedia Hackathons are generally collaborative computer programming events lasting between 2 and 4 days which specifically focus on technologies and projects powering Wikipedia and thousands of MediaWiki installations. Some hackathons have specific focuses while others are open to any activities related to MediaWiki and Wikimedia tech.

Why should I attend a Hackathon?

[edit]

Wikimedia hackathons are essentially large development community meet-ups that attract many developers and designers who care deeply about the issues and technology impacting MediaWiki and the Wikimedia Projects. You will get a chance to work together with other developers, designers, and Wikimedians, in a productive, fun, and supportive environment. People end up organically grouping together based on their shared interests and projects. You will make new friends and allies, and meet in person people you have been interacting with online. Hackathons are fun!

How to make my first Hackathon a great experience?

[edit]

Be curious. Don't be afraid of feeling embarrassed for any questions - everyone started somewhere, and people learn together. Listen to people and get to know each other (even if it's only a "What are you doing in Wikimedia?" question). Wikimedia is a diverse community with lots of different backgrounds. If you are shy and feel like you don't know many people, do not worry: People are friendly and you will feel welcome.

You can also sit back and learn about other people's projects and sit through some introduction sessions, before you decide how you want to spend your time; however, if you already know what you want to work on, feel free to jump right in, hack away, and only resurface for coffee breaks and meals.

Formal or informal social events are often included alongside the regular hacking schedule, which allow participants to take breaks from work and get to know each other even further.

What is Phabricator and how is it used at hackathons?

[edit]

To successfully integrate with a Wikimedia-related hackathon, you will need to sign up for an account with Phabricator and learn the basics of its use.

Phabricator is a tool used for MediaWiki and Wikimedia projects to develop software, track bugs, and manage projects, among other things. At hackathons, it is used for session and project tracking and discussion, skill shares, and event-changes. It has even been used to organize the entire event!

Some examples of Phabricator workboards for Wikimedia-related hackathons (keep in mind the workboard will look different before, during and after an event):

Explain the differences between the Wikimedia Hackathon and the Wikimania Hackathon?

[edit]

The Wikimedia Hackathon (formerly known as the MediaWiki Hackathon or the Wikipedia Hackathon) and the Wikimania Hackathon are both yearly events run by the Wikimedia Foundation in partnership with a local chapter or group.

The Wikimedia Hackathon is generally a smaller and more focused event. The number of participants ranges between 150 - 250 people. It is always useful to integrate local developers who are new to Wikimedia projects, as well as 3rd party developers; however, Wikimedia Hackathons generally have a higher percentage of people who have been to previous hackathon events. There is usually an intensive mentoring program where newcomers are given support so that they can find a Wikimedia project they can work on.

Locations of Wikimedia Hackathons:

The Wikimania Hackathon is a hackathon that happens alongside the yearly Wikimania event. It usually takes place the two days in advance of Wikimania and, depending on the size of Wikimania, is often a larger event than the MediaWiki Hackathon but in some cases can be smaller. The number of participants has been as high as 400. While many returning developers attend Wikimania and the Wikimania Hackathon, there is often a much higher percentage of newcomers and local developers. Wikimania Hackathons usually have a lot of focus on on-boarding and newcomer-friendly tracks and projects, and also have some projects for non-technical contributors who want to help with translation or documentation support. Anybody who wants to help and has a development background, or is curious to learn more about the technology, is welcome!

Locations of Wikimania Hackathons:

Is there a Code of Conduct?

[edit]

Yes. All Wikimedia-related hackathons are covered by the Code of Conduct. See how to report a problem.

How do I find a project to work on during a hackathon?

[edit]
  • You can come with your own project related to improving or creating something specific
  • You can also plan in advance to work with other developers on somebody else's project
  • You can participate in the mentoring program
  • You can come without a plan, spend some time going to sessions and talking to people and find a project organically at the event

Make sure to look at the Hackathon's Phabricator work-board which should be linked on the Hackathon's wiki homepage on Mediawiki.org or Wikimania(year).org. If you find a project you really want to work on or hear more about, you can ask questions and coordinate with the project coordinators in advance of the event. You can add yourself to the Phabricator task and jump in to start discussing.

If you would like to be connected with developers who are working on a specific type of project, you can always email the organizers and ask to be connected in advance of the hackathon.

How do I get other people to help work on my project?

[edit]

Some Ideas:

  • Add your project to the Hackathon's Phabricator work-board and ask for volunteers.
  • Email wikitech-l@ in advance of the hackathon with a request for volunteers.
  • Schedule a session or mention your project early on in the hackathon, explain what you will be doing, give some background and ask for volunteers.
  • Stake out a table at the hackathon and use a provided mini-whiteboard or sign to indicate what you are working on.
  • Introduce your sessions during the hackathon opening where participates are given the option to do "open mic"

I want to give a talk or teach people something at the hackathon, how do I get a meeting room to schedule my session/talk/discussion:

[edit]

Wikimedia Hackathon schedules are constantly edited and anyone with a reasonable proposal for a talk or session can schedule it themselves before or during the event as long as there is meeting room space available (which there almost always is). You need to create a task in Phabricator to explain when you are hoping to accomplish during your session and then you can link the task directly onto the event schedule in a room that fits your needs.

Should my project be something small that I start and complete within the hackathon, or can it be a bigger project using the event as a time to make progress?

[edit]

Either, although the end of the event will include a showcase of projects. These typically focus on small projects completed during the event.

What kinds of projects are appropriate?

[edit]

Whatever you can imagine! Previous projects have ranged from a "geeky" command-line prompt interface to MediaWiki API to a "silly" tool generating Haiku poetry based on the recent changes feed to a SPARQL query engine for Wikidata that accepts human language questions. See many examples in:

What if I'm not a developer?

[edit]

Hackathons are generally meant for developers, but keep reading!

Designers are welcome, you can partner with developers on a project to help make it a reality with a good-looking UI!

Multilingual people: Sometimes there are also language translation sprints, so if you speak other languages than English, check with the hackathon organizers to see if something like that will be taking pace at the event in question.

Documentation sprints also take place at these hackathons, and participants do not necessarily need a technical background to get involved.

If you are not a developer, one option is to pair with a developer who would like input from someone else (ideas for user interface, help test, feedback from a different perspective, bug hunting). There are other opportunities for contributions to the MediaWiki community. Perhaps you could improve MediaWiki documentation or help the MediaWiki community teams with planning.

There are other Wikimedia-related collaborative events and project, like meetups, editathons, wiki loves monuments, etc. Check them out!

Non-technical forms of support needed:

  • Social: Volunteers are always needed to help people meet each other, get signed up for the showcase, and help projects in need find more people.
  • Project Management: Help a person or team be even more efficient in working towards their goal
  • Presentation expertise: Help hacking teams work on their demo-able showcase presentation. You can help them create good-looking slides or a video.
  • Design work: many projects need design work!
  • Translation support
  • Documentation support
  • Testing support
  • More!

What if I am not a "Wikimedian"?

[edit]

No problem; every future Wikimedian has to start somewhere. Come to an event, meet others, and get involved!

What happens at the hackathon showcase?

[edit]

The hackathon showcase is for people to present the work that they have completed at the hackathon. Ideally, whenever possible, people should work on projects that are demo-able, and teams should spend a little bit of time putting together a video, slides or just a collection of links to show off at the showcase.

Generally, each team gets about 2 minutes to show the world what they have done!

The attempt is always to showcase as many projects as possible, as quickly as possible.

Are there prizes?

[edit]

Rarely, and when they exist, they are generally a small token of appreciation (t-shirt, public thank you). These hackathons are focused on volunteerism and community recognition.

Are scholarships available?

[edit]

Generally, yes. Check the specific event page for more information. Often you need to plan and apply reasonably far in advance for a scholarship. Most events will have scholarship registration deadlines posted. If the event is coming up and the deadline for scholarships has passed, there is no harm in emailing the organizing team, letting them know how you want to contribute to the event and seeing if there is anything that can be done.

Where can I find more information?

[edit]

Optional: If you want to look further into the world of MediaWiki, here are some more resources you can check out:

General sources for MediaWiki

[edit]

Resources from the MediaWiki pre-hackathon workshops in 2017

[edit]
  • List of resources for installing MediaWiki on a server and getting started with PHP & Co, 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

[edit]