Thank you for being so interested in participating in Dev Days, an event hosted by the Academy Software Foundation. This document is a general outline of the expectations for participating in this event.
What is Dev Days?
Dev Days is a two-day virtual hackathon where individuals who have never participated in one of the Academy Software Foundation projects ( or even open source in general ) can pick a task that can be completed in one day. The aim is to help individuals make their first contribution to a project, with a focus on each of the participating projects, to ensure they have maintainers and other contributors available to mentor and support these first-time contributors.
...
This is for you to get something out of, but it's also for us as a company. These projects are not just fun, do-gooder tasks. Almost everyone is a critical technology underlying our tools and productions. Sometimes, though, we may have only one person who is knowledgeable about the internals and feels comfortable fixing or enhancing these projects, and that's a risk, given how important they are. So it's helpful for us to have multiple people who feel like they can jump in and make changes needed."
How to participate in Dev Days?
Participation in Dev Days is easy to do. Follow the steps below to get started.
Register as a Dev Days participant.
Register as a Dev Days participant at XXX. Participating is free, and by registering, you will be eligible to get the 'Dev Days Participant' digital badge upon completion.
...
- Create a GitHub Account
- How to make a Pull Request by example
- First-timers guide to contributing to open source.
Check out and pick a project.
If you are totally new to the ASWF, explore the list of projects here. Read about the different projects and focus areas, and see what jumps out to you. If you are already interested in a particular project, great!
Next, review the list of projects and open issues for Dev Days participants to tackle on CLOTributor. Pay attention to the various tags on each issue to help guide your selections.
...
It's a good idea to narrow it down to a few issues of interest and then reach out to the person who opened the issue project to ask questions. The easiest way is often to comment on the issue itself, but you can also connect on the project's communication channels ( find the full list here ). Some questions you should could ask include.
- What skills or knowledge is needed to complete this issue?
- Are there any "gotchas" that one should be aware of?
- Are there tools or a specific development environment setup needed?
...
- Let the project know, and they will assign it to you.
- Most projects require contributors to be covered under a Contributor License Agreement (CLA). Each project should have a CONTRIBUTING page in its code repository or documentation outlining this requirement and other contributions requirements. There are two forms of CLAs.
- Individual (ICLA) is used if you are not affiliated with an organization and only contribute on your behalf.
- Corporate (CCLA) is used if you are an employee of a company, and your contributions would be made on behalf of the company. Even if you are not participating as part of your employer's work, your employment contract often indicates that your employer owns any open-source contributions. You should consult with your employer for more details.
- Set up your development environment. Each project should outline this either in a README file, a BUILD file, or as part of its documentation. If you can't find this information or have questions, contact the project directly.
- Make sure you join the project's communication channels and any meetings before Dev Days that the project may request participants join.
Participating in Dev Days
On the days of Dev Days, be ready to start working! To make the experience productive for you and the project, as well as reduce the amount of frustration you might have, here are a few tips:
...
Most importantly, have fun! Making your first contribution to a project can seem daunting, but once you do, it is quite rewarding.
Further Questions
If you have any other questions, reach out on the #devdays channel on the Academy Software Foundation Slack. If the question is project-specific, reach out to the specific channel(s) they recommend.
...