01. Getting Started

Your First Open Source Starter Kit: Tools, Accounts, Habits

Before your first contribution, set up the basic tools, accounts, and habits that help you join Open Source projects with less confusion.
Table of Contents
In: 01. Getting Started

Starting in Open Source can feel like walking into a busy workshop where everyone already knows where the tools are. You may know how to code, but still wonder what account to create, what to install, what to say, and how not to break anything.

This guide is a simple starter kit. It is not about becoming an expert. It is about setting up the basic tools and habits that let you participate in public software projects with more confidence.

Open Source works because people make their work visible. Code, questions, decisions, bugs, and improvements are shared where others can inspect them, learn from them, and build on them. Your starter kit helps you join that shared process.


Start with the accounts you need

Most Open Source projects live on public code hosting platforms. GitHub, GitLab, and similar services give projects a place to store code, discuss changes, track bugs, and review contributions.

You do not need to create accounts everywhere. Start with one platform used by a project you care about.

  • Use a clear username: It does not have to be your legal name, but it should be professional enough for public collaboration.
  • Add a short profile: One or two lines about what you build, what you are learning, and what kinds of projects interest you.
  • Use a reliable email: You will receive notifications about discussions, reviews, and project updates.
  • Turn on two-factor authentication: Public projects depend on trust. Protecting your account is part of being a good participant.

Your profile is not a résumé contest. It is a signal that a real person is here to learn and contribute responsibly.


Install the basic tools

You do not need a complicated development setup to begin. You need enough tooling to read code, run a project when you are ready, and keep your work separate from the main project.

  • Git: Git tracks changes to files. It lets many people work on the same project without overwriting each other.
  • A code editor: Use one you already understand. The best editor for getting started is the one that does not slow you down.
  • A terminal: Many Open Source instructions assume you can run basic commands. You only need simple navigation at first.
  • A package manager: Depending on the project, this might be npm, pip, cargo, composer, or another tool used to install dependencies.

If a project has setup instructions, follow them exactly before improving them. If the instructions fail, write down what happened. That note may become a useful first contribution later.


Learn the three places where work happens

Every project has its own style, but most Open Source work happens in three public places.

  • The code: This is the software itself. It may include application files, tests, configuration, and documentation.
  • The discussion: This is where people ask questions, explain problems, propose ideas, and make decisions.
  • The history: This shows what changed, when it changed, and often why it changed.

Beginners often jump straight into changing code. A better first step is to read the project like a map. Look at the README, the contribution guide, recent discussions, and recent changes. You are learning how the project thinks.

This matters for public benefit software. A project that helps teachers manage classroom resources, for example, may have code decisions tied to low-bandwidth access, student privacy, or old devices. Reading the context helps you avoid changes that look fine technically but miss the needs of the people being served.


Set up your communication habits

Open Source is written collaboration. Your words become part of the project record. You do not need to sound fancy, but you should be clear, kind, and specific.

  • Ask one question at a time: Long, mixed questions are harder to answer.
  • Share what you tried: Include the command you ran, the file you read, or the behavior you expected.
  • Avoid urgency unless it is real: Most maintainers are balancing many demands.
  • Respect project boundaries: If maintainers say they are not accepting a certain kind of change, listen.
  • Thank people for reviews: Feedback is part of the work, not a personal attack.

A useful beginner message might be: I am new to this project and tried running the setup steps on a fresh machine. Step three failed with this error. I may be missing something, but I wanted to check whether the docs need an update.

That message is specific, humble, and useful. It gives others something they can respond to.


Practice with a public benefit example

Imagine you find an Open Source project that creates free reading practice tools for adult learners. The project matters because paid learning software may be out of reach for some community programs.

Before you contribute, your starter kit might look like this:

  1. Create or update your code hosting profile with a short note about your interest in education technology.
  2. Install Git and the project’s required language tools.
  3. Read the README, license, and contribution guide.
  4. Look at recent discussions to see what maintainers are focused on.
  5. Try running the app locally without changing anything.
  6. Write down any setup confusion in a small, respectful note.

Even if you do not submit code that day, you are learning how the project works. You are also noticing whether the project is approachable for the next beginner. That observation is valuable.


Make a small personal checklist

Before joining any new Open Source project, run through this quick checklist:

  • Can I explain what the project does in one sentence?
  • Do I know who the software is meant to help?
  • Have I read the README and contribution notes?
  • Do I understand how the project wants people to communicate?
  • Can I run or inspect the project without guessing too much?
  • Have I started with a question or task small enough to finish?

If the answer to several of these is no, slow down. Getting oriented is not wasted time. It is how you avoid creating extra work for maintainers and how you make better contributions later.


Why this supports software that benefits all people

Software for Progress Foundation exists to help Open Source developers create software that benefits all people. That goal depends on more than code. It depends on projects that are understandable, welcoming, secure, and sustainable enough to keep serving their communities.

Beginners help make that possible. When you document confusing setup steps, ask clear questions, protect your account, and learn the needs behind a project, you strengthen the path for everyone who comes after you.

Your first contribution may be small. Your first habit matters more: participate in a way that leaves the project better than you found it.


TL;DR

  • Open Source is public collaboration around software, not just public code.
  • Set up one code hosting account, a clear profile, Git, an editor, and basic project tools.
  • Read the project before changing it: docs, discussions, history, and contribution notes.
  • Communicate clearly, kindly, and specifically.
  • Start with small observations and questions, especially in projects serving education, accessibility, security, or community needs.
  • Good beginner habits help Open Source projects become more sustainable and useful to the people who need them.
Written By
Cory Fail
Cory Fail leads the Software for Progress Foundation, helping developers build Open Source tools for education, accessibility, and social good through mentorship and community support.
Comments
More From Software for Progress Foundation
Great! You’ve successfully signed up.
Welcome back! You've successfully signed in.
You've successfully subscribed to Software for Progress Foundation.
Your link has expired.
Success! Check your email for magic link to sign-in.
Success! Your billing info has been updated.
Your billing was not updated.