Project: Creating a Hackathon Handbook

Contractor: Sonja Fischbauer
Point of contact at WMF: Rachel Farrand

Duration: 3 weeks (June 12 - June 30)
Statement of Work:

⁃ During the Term, Service Provider’s primary services and deliverable under this Statement of Work will be to create a guide for organizers of Wikimedia hackathons and other technical events.
⁃ In particular, Service Provider will be responsible for:
⁃ Identifying and cataloguing all the existing documentation spread in wikis and other documents that may be of interest for Wikimedia Hackathon organizers, as well as organizers of smaller technical events.
⁃ Capturing in writing the lessons learned and programs that worked well from the Wikimedia Hackathon 2017 event held in Vienna, Austria.
⁃ Updating, integrating, and synthesizing all the information above into a comprehensive written structure to be used as a guide for future organizers of Wikimedia Hackathons and other technical events.
⁃ Placing special emphasis on the use of concise language and plain English, in order to make the documentation readable, useful, and translatable.
⁃ Paying special attention to generic documentation relevant to all event organizers, including non-technical events, and special sections specific to WMF’s larger, global hackathons. A good structure with these different levels will allow this documentation to be widely used by the Wikimedia Movement. >> during all weeks, but especially important during creating the structure
⁃ Delivering the catalogue of existing documentation, the captured lessons learned and programs that worked well, and the comprehensive guide to WMF by June 30, 2017

Timeline:

Week 1:
• Identifying and cataloguing all the existing documentation spread in wikis and other documents that may be of interest for Wikimedia Hackathon organizers, as well as organizers of
smaller technical events. collected here: https://www.mediawiki.org/wiki/User:Sonkiki/Handbook
• creating draft for a a comprehensive written structure (paying special attention to generic documentation relevant to all kinds of events)
• kick-off meeting between Sonja + Rachel on first day of project (Mon 12 June)
• second meeting with Rachel 4 days in, to check whether we're still on track (The 15 June)
• collecting feedback from TC team regarding formatting

Week 2:
• updating the structure as needed
• writing lessons learned and programs that worked well from the Wikimedia Hackathon 2017 in Vienna. work in cooperation with @Claudia Garad + WMAT team
• put emphasis on diversity measures and mentoring program / newcomer engagement
• meeting with Rachel (Tue 20 June)

Week 3:
• Fleshing out the structure: Updating, integrating, and synthesizing all the information above into the comprehensive written structure (again, special attention to generic documentation relevant to all kinds of events)
• adding reader-friendly formatting for better usability (tables, fotos, etc.)
• meeting with Rachel (Wed 28 June)
• Mid-week: send out for final review
• integrate final review