A step-by-step guide for everyone in getting started their open-source journey.
Many beginners (developers or non-developers) find it challenging to contribute to open source projects. They may feel that they are not skilled enough or that they don't know how to get involved. However, this is not true. Anyone can contribute to open source, regardless of their level of expertise. The key is to how a learning and helping others mindset, following the best practices and follow the specific guidelines of each project.
This repository provides a basic roadmap for anyone who wants to start their open source journey from scratch. It covers the essential steps and tools that you need to become a successful open source contributor.
- What is Open Source?
- Benefits of Contributing in Open Source
- Find your Passion
- Find a project to contribute
- Do I have the right skills?
- Learning the right skills
- Make your first contact
- Communicate Effectively and ask smart questions
- How to understand Large and Complex Codebases
- Don't hesistate to help others
- Document your journey
- Slides
The term open source means that anyone can see, understand, learn, modify or distribute (depending upon the license) the source code of the software. The amazing technology that we using now a days become possible due to the rise of open source movement.
The source code of:
- Linux
- Blender
- Android
- Firefox
- Chromium
- Apache HTTP Server
- MySQL
- Git
- TensorFlow
- PyTorch
- VsCodium
- GIMP
- VLC
- InkScape
- FFmpeg
- Kubernetes
- Docker
- MongoDB
- Godot
- Krita
- Almost all the programming languages
And even many machine learning models like Meta LLAMA 2 and OpenAi's general-purpose speech recognition model Whisper are open source. Also, there are some open source games like Doom. All of these are open source projects. You can see their source code, learn from them, modify them, and even contribute to them. You can also use them in your own projects. This is the power of open source.
The main philosophy of open-source products is the freedom to think, create, learn, and share. It is a collaborative effort of many developers who are working together to create something amazing. In the early phases of technology, open source helps the technology to not become handicapped by some big entities and is developed by people who really have the passion to make that piece of technology better.
As a complete beginner in technology we face a common problem that we are unable to make our hands dirty on the products or softwares that we uses in our daily life and the softwares that powers the whole world. Here, open source solves the problem.
By working in open source project you
- Understand the magic behind the amazing technology.
- Improve your skills by working with other developers.
- Work and learn from the best developers and technology.
- Making an impact on the world by contributing to the projects that was used by millions.
- Open your door to the world of opportunities.
- Learn people skills like communication, teamwork, leadership, etc.
- Work on the thing that you are passionate about.
- Getting paid (as a job or through some programs)
If you want to know that open source is for you or not, then ask these questions to yourself:
- Do you want become a technology maker?
- Do you want to grow your network?
- Do you like improving the technology that you uses in your daily life.
- Building a community?
You will be much more successful if you work on your passion. Therefore, the first is that we have to find our passion.
- The thing which you like to do in your free time.
- Which thing excites you the most?
- The thing which you do without any external or monetary motivation.
- Where are you seeing yourself in next 2-3 years.
- Find the intersection of your passion and your technology.
For some people it's like gaming or art, or poetry which they love to do in their free. For example, if you like art then you can contribute to the artisitic softwares like blender, inkscape, gimp, openshot, krita. This way you can improve your skills, learn from the best developers and make an impact on the world.
Now, you have identified your passion. The next step is to find a project to contribute. Selecting a project is one of the crucial step in your open source journey.
Identify the project that you uses in your daily life. This is the best way to find a project to contribute. As you have the passion for that project and you know the pain features that you want to add or improve in that project.
- One of the easiest way to find the project and the welcoming community is using Google Summer Of Code website.
- Just go there, and search for the term that you are passionte about you will find organizations the work on that technology.
- Use GitHub Explore
- See GitHub trending repositories
- See GitHub choosing a project
- Open Source Friday
- First Timers Only
- CodeTriage
- 24 Pull Requests
- Up For Grabs
- First Contributions
- SourceSort
- OpenSauced
- Ovio
- For finding good first issues on this platform use this search powerful issue search tool
- Contribute-To-This-Project
- Open Source Welcome Committee
See freeCodeCamp/how-to-contribute-to-open-source for more resources.
One of the myth that people have is that they need to be an expert in order to contribute to open source. This is not true. You don't need to be an expert to contribute to open source. You just need to have the right skills.
- You know where to find help.
- You learn from the feedback and respond well to it.
- You can work in a team or independently.
- You know when to ask questions.
- You can communicate effectively.
- Respect other people's opinions.
Note: If you are not interested in Developer side, then you can also look for Google Summer Of Docs program, which are specifically tailored for technical writing people.
- You know the basics of a specific programming language.
- You can fix common issues which are related to the project.
- You have basic experience of a project workflow.
- Knowledge of Git and GitHub is a plus.
The right skills depend on the project that you want to contribute. For example, if you want to contribute to a Python project then you should know the basics of Python. First identify your project and then learn the skills that are required for that project.
-
Use class central website
-
Use edX website
-
Use Coursera website
-
Use Udemy website
-
Use Udacity website
-
Use Khan Academy website
-
Use Codecademy website
-
Use freeCodeCamp website
-
Use YouTube website
-
For learning more best universities, use this: https://csdiy.wiki/en/
Learning how to use search engine is also a great skill to have, which you can learn from here:
See GitHub Flow for learning Git and GitHub. A more detailed guide is freeCodeCamp/how-to-contribute-to-open-source
Now, you have the right skills and you have identified the project that you want to contribute. The next step is to make your first contact with the community.
- See the CONTRIBUTING.md or building instructions of that project.
- Read the documentation of that project.
- Build the project on your local machine.
- Run the tests.
- In this process if find any issue then try to fix it, introduce yourself to the community, raise a PR or an issue.
- This is the best way to make your first contact with the community.
- If you don't find any good-first-issue then you can also introduce yourself to the community, ask for help, or ask for a good first issue.
- Try to find answer yourself.
- Searching the archives of the forum or mailing list.
- Searching web.
- Reading documentation.
- Ask a skilled friend.
- Make it easy to reply.
- Don’t spam.
- Don’t dm mentors or org admins.
- Be Precise & Informative about your Problems
Read this interesting guide http://www.catb.org/~esr/faqs/smart-questions.html for more information.
Understanding the code which was developed by experienced developers over a long period of time is a challenging task. Therefore, don't expect the code by just looking at it. You have to understand the codebase in a systematic way. These are the steps that you can follow to understand the codebase.
- Read the documentation.
- Don't dive into the codebase without any purpose.
- Atleast know the basics of the programming language.
- Read the theoritcal aspect of the project.
- Find a specfic task that you want to do and then ask or find which part of the codebase is responsible for that task.
- Use the debugger to understand the codebase.
- Use the search feature of the codebase to find the specific code.
- Use
git blameto find the author or context of the code.
- Open source is all about learning and helping others. If you find a beginner who is struggling with the same problem that you have faced in the past then don't hesistate to help them. Motivate and refer them to the right resources. This way you can also improve your skills and build a network.
Documenting your journey is the best to help others or maybe your future self in understanding the process that you have followed. You can document your journey in the form of a blog, video, or a GitHub repository. Documenting your joureny through blog is the easiest way to get started. You can use
For writing blogs, or if you want to host your personal you can use these static site generators: