At Osmosoft, we have been engaging in a one-day hackathon about every month or so. There are several benefits:
- It helps us prove our tech in a range of application contexts.
- It helps us spread the word about web standards and why everything needs its own URI.
- It helps us demonstrate and gain experience in agile processes.
- It gets us Osmosofties working together in the same place at the same time, whereas day-to-day we tend to work on products in small groups or individually.
The WikiData HackathonThe latest hackathon was last Thursday, July 16, which saw us collaborate with Avox, a company specialising in business entity data. I believe it's working in a similar space to companies like Dunn and Bradstreet and other information providers, in that they collect, verify, and report information about companies. Avox is keen to open up parts of their database and gain the benefits of community feedback - with users being able to contribute information, leave comments, add new companies, and so on. Of course, Avox is in the business of gathering verified data, so it's not just a case of making a new wiki and letting it run by itself. There remain challenges about how Avox will merge and verify community input, and how they will make it clear to users what's verified and what's not.
Pre-WorkWe had a conversation on the mailing list about what we did last time and what could do differently for this hackathon. Like a retrospective, but over email. TiddlyWeb architect Chris Dent set up some instances with sample data taken from the existing product.
Venue and AttendanceThe hackathon took place in Osmosoft's office, centered around our big table in the centre of the room. Seven people from Avox, in a range of technical and non-technical roles, attended for the duration of the event. Osmosoft had five developers working on stories, a developer working on integration and mediation, and another helping with the server and offering second-line support.
Introductions and Overview (about 1 hour)We went round the table and everyone introduced themselves. Jeremy Ruston explained "what's in it" for Osmosoft, as outlined above, and Ken Price outlined Avox's interest in building wikidata. We also looked at the existing product. We then had a discussion which was mostly Osmosoft people asking Avox people questions about the nature of their business, the technologies involves, and their vision for wikidata. Paul began writing down stories on flashcards during this time.
User Stories (about 1 hour)We finished writing stories - this was somewhat in parallel to the previous activity - and put them all up on the wall, with the magic of Blu-Tac. The stories were in the form "As a (role), I want to (task), so that I can (benefit)". With about 20 stories, it was useful to organise them, so we grouped them according to the role. The main roles were for Avox staff and general users. There were also some stories involving 3rd party developers and employees of companies listed in the wiki. Everyone gathered around the stories, we read them out, and we all agreed on priorities. We didn't worry too much about ordering the stories at the bottom as it was unlikely we'd get to them during the event; if we did, we could prioritise later. What we ended up with was a solid idea of the steel thread we were building. It would mostly be standard wiki functionality, but applied to the particular data and context of companies info. We had some bonus stories we could implement if we had time, like comments and tagging.
Planning and Infrastructure(about 30 minutes)Developers put their initials against the first story they'd be working on, and likewise each story needed a customer representative to initial the story, so they would help refine requirements. In the event, we didn't talk all that much with customers during development; it's obviously an extremely important thing to do in a real project, but when you're wanting to get real functionality out in a day, the cost of a conversation is relatively high and the benefit to the task is relatively low. It would have been different in a 2-3 day event, or with certain stories that are highly specific to the domain. The main thing was to checkpoint with customers to check that we're generally on track. Around noon, we drew up a timeline and agreed on a hard stop at 7pm. This means we timebox - the time is fixed and the only variable is the number of stories that get implemented in that time. We then got into
Presentation (about 45 minutes)After the usual last-minute rush, we got a working product deployed. It must be noted that we let the "hard stop" slip by about 45 minutes, to about 7:30. Admittedly a bad practice, but it did yield some major results in this case, as it got us search, edit, and maps all working during that time. Each of the developers explained what they'd worked on. We then gathered round the screen and walked through the app. Avox gave their thoughts, I recorded the video above while others broke out into informal conversations, and by that point, it was pub o'clock. We were able to produce the steel thread we'd been planning; the key stories were demonstrated. We also implemented commenting and Google Maps integration. Being based on TiddlyWeb means we had also produced a working API "for free"; it's just the nature of TiddlyWeb as a RESTful data container. (On a personal note, commenting was the main thing I did - I extracted the comments feature from Scrumptious into a standalone plugin, and integrated it into the emerging WikiData product. I'll post about that separately.)
About the VideoI recorded the video above at the end of the event. One of my bugbears about hackathon events is that people spend all day coding and setting up infrastructure, and it inevitably comes down after that, or gradually falls apart as various third-party services close, databases get corrupted, people forget to keep hosting it, etc etc. In other words, you have to assume the online result of any hackathon event is transient. This is unfortunate, because the deliverable should be something that people can use to decide what happens next, whether to fund a project, and so on. While meeting minutes are often a waste of time, the artifacts that emerge in a workshop are critical to followup. For that reason, I am perfectly passionate about taking a screencast or video to capture what took place in such events. Thanks to Paul and Ken for taking part in it. Update: Avox CEO Ken Price (who appears in the video), has published a summary of the event.