User:Sonkiki/Handbook Project

This is my working page for a 3-week project as a contractor for WMF, with the goal of creating a hackathon/ event handbook.



Journal
disclaimer: this journal may not be complete

Week 1

Mon, 12 June: First day, trying to get into it, clicking my way through various wiki pages, made a timeline, currently collecting everything here: https://etherpad.wikimedia.org/p/Sonja. Kick-off call with Rachel Farrand in the evening.

Tue, 13 June: encountering some issues with creating wiki pages, troubleshooting by Raimund Liebert (WMAT). Found out that Jean-Frédéric has started a handbook in 2014: User:Jean-Frédéric/Hackathon handbook and that Wenke from WMDE is working on an event guidebook in German as well.

Wed 14 June: got a lot of good suggestions for what it should look like, and what not, from WMF, Quim Gil, as well as community engagement team (Sherry Synyder, Chris Koerner, Nick Wilson, Benoit Evellin, ...).

+ include glossary

+ timeline with very specific instructions (e.g. NO:  "Think about branding", YES: "Four weeks before wedding:  Tell future mother-in-law how chic she will look in solid black mourning clothes." OR "Six months before hackathon: Assign one person to be in charge of encouraging participation by different kinds of people")

+ clear page with comprehensive view (good examples: Help:Flow, https://www.ted.com/participate/organize-a-local-tedx-event)

+ modular structure (example of Asian restaurant menus to build-your-own meal)

+ keep it KISS (avoid hard to collaborate on formatting like on Help:VisualEditor/User guide)

Ressources
Etherpads: Rachel Meeting Notes: https://etherpad.wikimedia.org/p/TC_Doc_Project

Now an archive: Collection of first thoughts/ ressources here: https://etherpad.wikimedia.org/p/Sonja

Learning patterns
https://meta.wikimedia.org/wiki/Category:Learning_patterns

two of them mention the word hackathon: This one could be useful, too: https://meta.wikimedia.org/wiki/Grants:Learning_patterns/Event_planning_process
 * https://meta.wikimedia.org/wiki/Grants:Learning_patterns/Coding_da_Vinci_-_the_culture_hackathon
 * https://meta.wikimedia.org/wiki/Grants:Learning_Patterns/How_to_design_and_develop_an_education_hackathon_within_the_Wikipedia_Education_Program

Main Locations (Pages) with general Hackathon/ Event related content:
https://www.mediawiki.org/wiki/Hackathons/

https://www.mediawiki.org/wiki/Project:Calendar

Accessibly:
https://meta.wikimedia.org/wiki/Events/Accessibility

Wikimania Handbook:
https://meta.wikimedia.org/wiki/Wikimania_Handbook

Page that comes the closest to a handbook:
Probably main Site that we will edit:

https://www.mediawiki.org/wiki/Hackathons/Hackathon_tips_for_organizers

Links to other documentations, internal and external

https://www.mediawiki.org/wiki/Hackathons/Hackathon_tips_for_organizers#Other_Hackathon_Tips

Project:Calendar
https://www.mediawiki.org/wiki/Project:Calendar

list of upcoming events related to MediaWiki development.

>> not up to date, e.g. Hackathon Vienna is missing

https://www.mediawiki.org/wiki/Project:Calendar/How_to_schedule_an_event

tips for all kinds of events, like meetups, developer summit, IRC office hours, etc.

3 chapters: general event suggestions, promotion and specific events (incl. hackathons)

>> this could be the main page where we collect all event info?

How-to Schedule Event on Project:Calendar Page
https://www.mediawiki.org/wiki/Project:Calendar/How_to_schedule_an_event#Hackathons

includes just a few links:
 * For organizers: https://www.mediawiki.org/wiki/Hackathons/Hackathon_tips_for_organizers
 * For participants: https://www.mediawiki.org/wiki/Hackathons/FAQ
 * For future organizers: https://www.mediawiki.org/wiki/Hackathons/Proposing_a_hackathon


 * Hosting chapter should publish budget/$ spent. Examples: Zurich: https://www.mediawiki.org/wiki/Zürich_Hackathon_2014/Budget, Amsterdam: https://www.mediawiki.org/wiki/Amsterdam_Hackathon_2013/Budget, Berlin.


 * Public lessons from hackathons. Examples: London: https://www.mediawiki.org/wiki/Project:Calendar/How_to_schedule_an_event/HackathonTips >> this is actually Logistical improvements/lessons from Wikimania 2014, Lyon https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2015/Lessons_Learned, Mexico City


 * Hackathon metrics: Lyon

List of Events:
All MediaWiki related Events: Events on mediawiki.org

All Wikimedia events: Events

Wikimania Haifa 2011 called "Developer Days": https://wikimania2011.wikimedia.org/wiki/Developer_Days

First Wikimedia Hackathon 2012, called “Berlin Hackathon”: https://www.mediawiki.org/wiki/Berlin_Hackathon_2012

Wikimania DC: https://wikimania2012.wikimedia.org/wiki/Hackathon

Wikimedia Hackathon 2013 Amsterdam: https://www.mediawiki.org/wiki/Amsterdam_Hackathon_2013

Wikimania Hong Kong 2013 "Dev Camp" (called instead of Hackathon): https://wikimania2013.wikimedia.org/wiki/DevCamp

Wikimedia Hackathon 2014 Zürich: https://www.mediawiki.org/wiki/Zürich_Hackathon_2014

Wikimedia Hackathon 2015 Lyon: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2015

Wikimania Hackathon 2015 Mexico City: https://wikimania2015.wikimedia.org/wiki/Hackathon

Wikimedia Hackathon 2016 Jerusalem: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2016

Wikimania Hackathon 2016 Esino Lario: https://wikimania2016.wikimedia.org/wiki/Hackathon

Wikimedia Hackathon 2017 Vienna: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2017

General Page about Lessons Learned from Hackathons:
Not linked to, work in progress:

https://www.mediawiki.org/wiki/Hackathons/LessonsLearned

List, not complete:
https://www.mediawiki.org/wiki/Hackathons/Hackathon_tips_for_organizers#Lessons_Learned_from_past_Wikimedia_developer_events

List of all Wikimanias, including Lessons learned but some links are red: https://meta.wikimedia.org/wiki/Wikimania

Specific Lessions Learned sorted by event / year:
2012 Wikimania DC: https://wikimania2012.wikimedia.org/wiki/Feedback
 * 2014 Wikimania London: https://www.mediawiki.org/wiki/Project:Calendar/How_to_schedule_an_event/HackathonTips
 * 2015 Lyon: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2015/Lessons_Learned
 * 2015 Wikimania Mexico City - https://wikimania2015.wikimedia.org/wiki/Feedback - are there any others, a collected Lessons Learned?
 * 2016 Jerusalem https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2016/Lessons_Learned
 * 2016 Wikimania Esino Lario: could not find lessons learned - are there any?
 * 2017 Vienna: https://www.mediawiki.org/wiki/Wikimedia_Hackathon_2017/Lessons_Learned >> to be filled

Links to past hackathon organization tracking:
https://phabricator.wikimedia.org/project/board/1326/query/all/ Wikimedia Hackathon 2016

https://phabricator.wikimedia.org/project/board/1919/query/all/ Wikimedia Hackathon 2017 <- Vienna this year

https://phabricator.wikimedia.org/project/board/1896/query/all/ Wikimania Hackathon 2016

https://phabricator.wikimedia.org/project/board/1033/query/all/ Wikimania Hackathon 2015 (org column)

https://phabricator.wikimedia.org/project/view/2806/ Wikimania Hackathon 2017 - nothing there yet

Templates
https://docs.google.com/document/u/0/?tgif=d&q=hackathon
 * For emails: see also Esino Lario Emails!
 * registration form
 * website text, maybe, too?