Hackathons/Handbook/Program

Program and sessions

Planning and scheduling content before the hackathon

While hackathons and content planning might seem almost incompatible, there are some content plans that help bringing interesting people with interesting skills to the event. Travel sponsorships and local developer outreach are more effective with a content plan in place. This plan also helps increasing the number of newcomers and diversity in general.

The ingredients of the plan:

• Community Wishlist tasks. The Technical Collaboration team selects 3 - 5 Community Wishlist tasks with lead developers confirmed, and help recruiting volunteers and organizing the work prior to the event. See Hackathons/Suggesting projects.
• Development tracks. The Technical Collaboration team reaches out to the Wikimedia tech community in order to identify groups that have a specific goal for the hackathon, from WMF teams to consolidated projects with capacity of mobilization.
• Local projects. The local organizers have an option to select hackathon goals in line with the priorities of the chapter and their community. The Technical Collaboration team can help finding lead developers and volunteers.
• Activities for newcomers. A track of introductory sessions is pre-scheduled with all the details and links to resources, allowing newcomers to prepare in advance. For instance:
  • Introduction to Wikimedia tech
  • Introduction to Phabricator
  • Introduction to Wikimedia Cloud Services
  • Translations workshop
  • MediaWiki-Vagrant workshop - or follow Hackathon/Laptop setup before travelling.
  • Other workshops around clonable microtasks, from the Google Code-in pool or similar kinds i.e. Adding TemplateData to templates.

Developer outreach before the event

As soon as the content plan starts to show some shape, with the first tasks selected and the first sessions scheduled, it is time to reach out to developers.

It is important to dedicate time for developer outreach beyond the regular Wikimedia tech channels, especially at a local level:

• local Wikimedia developers
• local tech ambassadors / technical translators
• local projects using Wikimedia tech or MediaWiki
• local developer groups

Successful contacts with local developer groups should influence the content plan of the event i.e. more Android activities if there is a strong Android developer community interested in the event.

Preparing the schedule

The availability of an interesting schedule is likely to drive developer attention beyond the usual participants in Wikimedia hackathons. Don't let all then information about logistics obfuscate the schedule.

• Publish an empty schedule as soon as you have decided rooms and time slots. Include lunch breaks and other timing details. Include details of each room like capacity and equipment.
• Schedule the sessions for newcomers, pointing to own pages with all the information about each session. These sessions are quite common across events, it is better to reuse and improve existing pages than to create new ones for each event.
• Post information about speakers and facilitators, including pictures. Newcomers are more likely to think that those sessions are a good fit for them if they know more about their speakers, and find a way to contact them with questions.
• (Should we try Phabricator Calendar to allow people to RSVP / subscribe?)

Sessions

Opening & Closing Sessions

The opening and closing sessions are for all hackathon participants. This is an example of a program

Opening

• Welcome / introduce the event by local host
• Welcome / introduce the event by WMF co-organizer
• If historically interesting introduce the venue
• How to navigate the event (phab, wikis, sessions sign up, etc)
• Logistics (social events, timing, transportation, help desk, etc)
• Save at least 20 minutes for participants to introduce their projects

Closing

• Thank you to hosts
• Thank you to volunteers!!!
• Showcase of projects (See #Showcase below)
• See you next year! Announce next location if it has been decided!

Don't print schedule of sessions in advance

Hackathons sessions are not all scheduled in advance. Many sessions are schedule on the first day of the conference or even an hour before the session will take place. If you print out a hard copy of the session schedule it will be out of date very quickly, but participants will still check it to see what is going on and miss out on session opportunities.

Tips:

• Projecting the schedule onto a TV screen or well directly from the wikipage (and reloading it regularly) is appreciated. Whenever we don't have this, multiple people request it.
• You can print out a hard copy of the schedule that does not include specific sessions but instead has meal times, opening/closing session times, social events, and breakout room information.
• If you can not project the schedule somewhere (reminder to only do this if the page automatically refreshes every five minuites) you can create a large paper schedule at the help desk and have your help-desk-staff check every half hour and write in sessions as they are scheduled.
• Announce in the opening of the event that they best place for up to date schedule information is on the event wiki

Sessions not edited until event

As an event organizer, don't worry if you have lots of meeting rooms and breakout spaces that look like they will be empty during the event. About half of sessions are not scheduled in advance of the hackathon and the more space you have the more ways people will find to use it. It is better to have more space and a few rooms that go empty sometimes than no space for people to do spur of the moment meetings.

If you end up having breakout room space left over you can still put it to good use

• Quiet room, a room away from noise where talking is not allowed. If you can, dedicate a room to this for the entire event.
• Loud groups can move to their own space
• Your own planning breakout sessions
• If the weather is nice and wifi works, some people like to move their sessions, discussions and hacking outside

Showcase

Setup the Showcase with these details:

• the shared computer on podium:
  • should be Linux (or any other Libre operating system. This means, let's avoid macOS and avoid Microsoft Windows). Better if this has an intuitive user interface! (OK: KDE, GNOME, ... not OK: dwm, ...)
  • English keyboard layout
  • clean your desktop to do not promote proprietary products / companies (like Microsoft Teams icons etc). Clean/hide your toolbar (also to protect your privacy). More Details in m:Wikimedians for software freedom#Talks and Showcases proprietary environments.
  • disable automatic screen lock (to avoid time wasting)
  • mouse
• ...

See this sample etherpad structure which can be copied to a new page. See examples of completed showcase notes in the "Outcomes" column of Hackathons/Previous_hackathons.

Remind the participants regularly, to signup for the showcase. You can put posters on the walls, show a static slide on the main room projector, go from table to table asking people to tell you about their work and help them to signup at the same time, or leave messages in shared chat-channels, such as

Good morning, Hackathon participants! While deeply submerged in all the Wikimania goodness, please do not forget about your appointment to share your hackathon work with the non-technical visitors of Wikimania in the Hackathon Showcase on Sunday!

You get two minutes two explain your work to those that will be directly impacted by it. That connection is really important; much of what we do and why is often ill understood or misunderstood, so the interactions here are super duper important.

Claim your spot at https://etherpad.wikimedia.org/p/Wikimania20XX-Hackathon_Showcase now and amaze us!

Or post concise channel topics in IRC and sticky messages in the Telegram channel with links.