Planning a Dev Days Event: An Internal Guide
Introduction
This outline details a successful Dev Days event plan from Animal Logic in 2024, offering guidance for organizing, social events, and post-event activities. It's not a rigid how-to guide, but a recount of steps that contributed to the event's success. The event's success stemmed from strategized planning, with a strong emphasis on structure—which was crucial as this was a new event within the company.
Purpose and Goals
The purpose is to maximize participation and/or introduce your company to the event and establish a foundation for future growth.
Our goals were:
Increase awareness of ASWF.
Secure participation from at least two team members from each technology department.
Establish in-house Project Informed Captains for all projects.
Ensure all pull requests are completed.
Encourage team member participation in open source beyond Dev Days.
We secured company support by submitting a proposal to leadership. This proposal included information such as: Dev Days' purpose and history (both within the company and ASWF); our proposed timeline, location, and reasoning for participation; the Dev Days process; participating projects; general contribution steps; our companies stakeholders (organizers, approvers, those needing awareness, and participants); the role of Project Informed Captains and who they are; planned social events; and a administrative task list for setup.
Steps
These are the steps we took to organize Dev Days at our company. While this isn't an exhaustive list—many more steps are possible—it provides a solid starting point!
# | Pre/During/Post Event | What | Details |
---|---|---|---|
1 | Pre | Choose an organizer and/or organizing committee. | This includes a project sponsor—a member of the leadership team who serves as your primary contact for company-level questions, providing support and encouragement for the event. |
2 | Create and present proposal. | Include on the following:
| |
3 | Identify and meet with Project Informed Captains. | Schedule a meeting with prospective Project Informed Captains to inform them of the event, request their participation and outline their responsibilities requests. Further details on Project Informed Captains (PICs) are provided below. | |
4 | Create Communication platforms. | Landing Page
Communication platforms
Storage
| |
5 | Promote the event. | Promotional emails and Slack/Team posts, announced the event and directed attendees to the landing page, highlighting upcoming information sessions. | |
6 | Send calendar invitations for virtual or in-person meetings. | Meeting schedule:
| |
7 | Host Dev Days Information Session. | Host a meeting with all potential participants to explain what Dev Days is. Have the project sponsor speak to the importance of the event, have each PIC introduce the participating projects, and share communication platforms. This meeting will provide an opportunity to answer FAQs. | |
8 | Host Project-Specific Information Session. | These meetings will vary, as project leads (PICs) may not be available for every project. They're designed to provide detailed descriptions of completed pull requests (PRs) and offer guidance to team members interested in joining. The meetings combine informational sessions with drop-in help. | |
9 | Create a registry for Dev Days participation. | In tandem with the instructions from the ASWF Dev Days website, we asked that all participants post in the company Slack or team channels to indicate their participation and specify the project/PR they are working on. We tracked this information to ensure that they would be set up properly and to provide assistance if needed during Dev Days. This also allowed us to track completions, and prior to the event, we were able to inform their manager about their participation. | |
10 | Check in with IT. | We held a meeting with IT to ensure that the infrastructure to contribute to open source code would be allowed, and we provided them with details about the event and the participation list. They had someone on standby during the Dev Days in case a firewall, etc needed to be opened. | |
11 | Established a budget and schedule for socials. | To generate excitement for the event, we provided lunch for participants and sweet treats for the entire Technology department. | |
12 | Environment setup help session. | This is an office hour for those who have already chosen their first issue. Individuals should have already verified if their environment is working or not. PICs are requested to be available during this meeting to answer participant questions. | |
13 | Set up CLAs (contributor licensing agreements). | Further details on CLAs below (contributor licensing agreements). | |
14 | During | Assistance during Dev Days. | We had a three-tier system for support during Dev Days. The first step was to reach out to the PICs (if available). The second step was to post your question in the company Dev Days channel for community support. The third step was to post on the official Dev Days or official project channel for help. We saw a spectrum of questions, ranging from those that could be easily answered (such as administrative ) to more difficult questions that required input from the wider open source community. |
15 | Host social. | There were two events: First, an invitation for lunch was sent to the participants. They were free to grab and go, or some chose to stay and discuss the projects they were working on. Second, an invitation was sent to all technology staff for the 'Dev Day Doughnut.' We used this time to allow participants to share their work with others, which piqued the interest of those who didn't participate. | |
16 | End-of-Event | At the end of the Dev Day work window, we checked in with participants to review the progress they had made and encouraged everyone to post updates in the company channel. | |
17 | Post | Event Summary | Following the Dev Days, we used the registry data to create a post-event report. A survey was also distributed to gather feedback on various aspects of the event, including coordination, setup, and contributions. Finally, we compiled information from the overall Dev Days project for internal team sharing. |
PICs (Project Informed Captains)
PICs are employees with prior experience contributing to AWSF projects. Ideally, they can offer guidance on a specific project but general knowledge of open-source is fine. PICs aren't necessarily managers; they can be anyone with prior experience or project knowledge. In fact, many past PICs were non-managers, or even employees unfamiliar with project contributions but knowledgeable about the project's purpose.
Identify your PICs by discussing with your leadership team. Individuals with with ties to AWSF and/or existing CLAs.
The PICs responsibilities are as follows:
Dev Days Information Session: Give a 5-minute overview of the project.
Project-Specific Information Session: Host a 15-30-minute detailed session outlining the project's goals, past contributions, and a Q&A.
Environment Setup Help Session: Be available for time to address participant environment setup questions.
Dev Days Event: Be available for to answer any questions on the day of the event.
Set up CLAs (contributor licensing agreements)
Company workflows for CLAs vary depending on leadership involvement. We found the most efficient approach involved having the Dev Days organizer also be a CLA Manager. This eliminated the need for additional approvals and prevented bottlenecks.
When participants expressed interest to join the event, the organizer/CLA Manager simultaneously requested any necessary information to add them to the project's active CLA.
Tips & Tricks
Send out event information 1.5 months before the event date, followed by weekly reminders to keep the event top-of-mind.
Develop a communication template for managers to use, enabling them to effectively share event details with their teams through internal communication channels.
During the event week, check whether participants have any conflicting priorities and communicate any concerns to their managers.
Ensure all participants have access to the #devdays and project-specific Slack channels.
Attachments