DEV Community

Cover image for The first pull request is the hardest door in software. I built a map with the door marked.
Ronak sarda
Ronak sarda

Posted on

The first pull request is the hardest door in software. I built a map with the door marked.

Everyone tells you to contribute to open source.

Nobody tells you where the door is.

You open GitHub and there are a hundred million repositories looking back at you. You search "good first issue" and the first ten are already taken. The next ten are in projects that last breathed two years ago. One looks perfect, so you spend an evening on it, and when you come back someone else has opened the PR. Or you open yours, and it sits there. No review, no comment, no answer. Just silence, which feels a lot like no.

So you close the tab. You tell yourself you'll do it when you're better. When you know more. When you're ready.

I did that for longer than I'd like to admit. Most people I know did too.

A map, not a list

I've been building GitSpace. It turns every GitHub account into an island floating in a night sky. Every repo you have ever pushed becomes a building on it. Small experiments are huts. The thing you're proud of is a tower. You fly a little ship between islands and visit other people's worlds.

It started as a toy. Then I watched people fly to their own island for the first time, and I saw something I didn't expect. They went quiet. Then they said, "I've built more than I thought."

That's the feeling I want to give people about open source too. Not another list. A way in.

The door, marked

There's a new button in the top bar now. It says First PR.

Press it and GitSpace looks at your island. It sees what you actually build with, maybe Python, maybe JavaScript, maybe C++, and it brings you a handful of beginner issues in exactly those languages. Not from abandoned projects. Not from giant ones where an easy issue vanishes in four minutes. It looks for projects that are alive: someone pushed this month, the issue is fresh, nobody has claimed it yet.

You pick one and press I'm on it. GitSpace checks with GitHub that the issue is still free, so you never walk into a room someone else just walked into.

Then you do the part only you can do. You read the code. You leave a comment saying you're working on it. You fix the thing. You open your pull request and write "Fixes #" and the issue number.

And you can stop refreshing GitHub. GitSpace keeps watch. When a maintainer merges your PR, it notices, and the button in your top bar changes from "First PR" to a number.

It's a small number. One.

What happens after one

Here's the part nobody tells you. The second PR is easy.

Not because the code gets easier. Because a maintainer now knows your name. They've seen your work and said yes to it. So after your first merge, GitSpace opens a new page: Your contributions. Every project you've helped, every pull request that landed, month by month. Your open-source life, finally in one place instead of scattered across a hundred tabs.

And it starts suggesting issues in the projects that already said yes to you. The door you walked through once stays open.

What it won't do

It won't write the code for you. It won't make the PR for you. It won't pretend a typo fix in some other corner of the repo was the issue you promised to solve. When it counts your PR, it's because you did what you said you'd do, in the project you said you'd do it in.

That's the point. The number in your top bar should mean something.

If you've been waiting to be ready

You're not going to feel ready. Nobody does. The people with forty merged PRs didn't feel ready for their first one either. They just found a door that was small enough to walk through.

Sign in to GitSpace with GitHub. Look at your island for a minute; you've built more than you think. Then press First PR.

Your door is on the map.

Top comments (0)