Your first pull request: a step-by-step walkthrough.

From forking a repo to getting merged — beginner friendly.

ৰিপ'জিটৰী এটা ফৰ্ক (fork) কৰাৰ পৰা আৰম্ভ কৰি মাৰ্জ (merge) হোৱালৈকে — নতুন শিকাৰুসকলৰ বাবে সৰল নিৰ্দেশিকা।

Making your first pull request feels like climbing a mountain — until you actually do it. This tutorial walks you through every single step, from creating a GitHub account to hitting the Merge button. We will keep it simple, practical, and beginner-friendly.

What is Git and GitHub?

Git is a version control system — it tracks changes in your code over time. Think of it like saving different versions of a document, but for code. GitHub is a website where developers store their Git repositories online and collaborate with others. When you contribute to a project on GitHub, you do this through a pull request.

Step 1: Create a GitHub account

If you do not have a GitHub account, go to github.com and sign up. Choose a username you are comfortable sharing publicly — this will be part of your developer identity. Use your real name or a recognizable handle so people know who you are.

Step 2: Fork the repository

Find the repository you want to contribute to — for example, one of the Axomiya IT Labs projects. Click the Fork button in the top right corner. This creates a copy of the project in your own GitHub account. You can now make changes to your copy without affecting the original.

Step 3: Clone the repository to your computer

Open your terminal and run: git clone https://github.com/YOUR-USERNAME/PROJECT-NAME.git

Replace YOUR-USERNAME with your GitHub username and PROJECT-NAME with the repository name. This downloads the code to your computer.

Step 4: Create a new branch

Never make changes directly to the main branch. Create a new branch instead: git checkout -b my-first-contribution

This creates a new branch called my-first-contribution and switches to it. You can name it anything descriptive — like fix-typo, add-translation, or update-readme.

Step 5: Make your changes

Open the project folder in your code editor. Make a small, focused change — fix a typo, add a translation, improve a sentence, or update documentation. Keep it simple for your first contribution. The smaller the change, the easier it is for maintainers to review and merge.

Step 6: Stage and commit your changes

In your terminal, run: git add . git commit -m “Add my first contribution”

The first command stages all your changes. The second commits them with a message describing what you did. Write clear commit messages — they help maintainers understand your changes.

Step 7: Push your branch to GitHub

git push origin my-first-contribution

This uploads your branch to your forked repository on GitHub.

Step 8: Open a pull request

Go to your forked repository on GitHub. You will see a banner suggesting you to open a pull request. Click it, write a clear title and description explaining what you changed and why, then submit. The maintainers will review your work and may ask for changes. Once approved, they will merge your contribution into the main project.

Common mistakes beginners make

  • Forgetting to pull the latest changes before starting
  • Pushing directly to main instead of creating a branch
  • Writing vague PR descriptions like “fixed stuff”
  • Making too many changes in one PR — keep it focused
  • Getting discouraged if maintainers ask for revisions — that is normal

What happens after you submit

A maintainer will review your pull request. They might say looks good, merge it, or ask you to make changes. If they ask for changes, do not take it personally — it is part of the process. Every contributor, even experienced ones, goes through review cycles.

Once your PR is merged, congratulations — you are now an open-source contributor! You can add this to your resume, share it on LinkedIn, and feel proud of your achievement.

Using AI to help

AI tools like GitHub Copilot or ChatGPT can help you understand code, write commit messages, or debug errors. But always review AI-generated code carefully before submitting. The goal is to learn, not to automate your way through contributions.

আপোনাৰ প্ৰথমটো পুল ৰিকুৱেষ্ট (pull request) কৰাটো পাহাৰ বগোৱাৰ দৰেই কঠিন যেন লাগিব পাৰে — যেতিয়ালৈকে আপুনি আচলতে কামটো নকৰে। এই নিৰ্দেশিকাটোৱে আপোনাক এটা গিটহাব (GitHub) একাউণ্ট খোলাৰ পৰা আৰম্ভ কৰি ‘Merge’ বুটামটো টিপালৈকে প্ৰতিটো পদক্ষেপৰ মাজেৰে লৈ যাব।

গিট আৰু গিটহাব (Git and GitHub) কি?

গিট (Git) হৈছে এক ভাৰ্ছন কণ্ট্ৰল ছিষ্টেম (version control system) — ই সময়ৰ লগে লগে আপোনাৰ ক’ডত হোৱা পৰিৱৰ্তনসমূহৰ হিচাপ ৰাখে। ইয়াক কোনো নথিপত্ৰৰ বিভিন্ন সংস্কৰণ সংৰক্ষণ কৰি ৰখাৰ দৰে ভাবিব পাৰে, কিন্তু ক’ডৰ বাবে। আনহাতে গিটহাব (GitHub) হৈছে এখন ৱেবছাইট য’ত ডেভেলপাৰসকলে তেওঁলোকৰ গিট ৰিপ’জিটৰীসমূহ (repositories) অনলাইনত সংৰক্ষণ কৰে আৰু আনৰ সৈতে মিলি কাম কৰে।

পদক্ষেপ ১: এটা গিটহাব একাউণ্ট খোলক

যদি আপোনাৰ গিটহাব একাউণ্ট নাই, তেন্তে github.com-লৈ গৈ পঞ্জীয়ন কৰক। ৰাজহুৱাভাৱে শ্বেয়াৰ কৰিবলৈ আপোনাৰ সুবিধা হোৱা এটা ইউজাৰনেম (username) বাছি লওক।

পদক্ষেপ ২: ৰিপ’জিটৰীটো ফৰ্ক (fork) কৰক

আপুনি যিটো ৰিপ’জিটৰীত অৱদান আগবঢ়াব বিচাৰে সেয়া বিচাৰি উলিয়াওক। Fork বুটামটোত ক্লিক কৰক। ই আপোনাৰ নিজৰ গিটহাব একাউণ্টত প্ৰকল্পটোৰ এটা কপি বা প্ৰতিলিপি সৃষ্টি কৰিব।

পদক্ষেপ ৩: ৰিপ’জিটৰীটো আপোনাৰ কম্পিউটাৰলৈ ক্ল’ন (clone) কৰক

আপোনাৰ টাৰ্মিনেল (terminal) খোলক আৰু লিখক: git clone https://github.com/YOUR-USERNAME/PROJECT-NAME.git ইয়াৰ জৰিয়তে ক’ডখিনি আপোনাৰ কম্পিউটাৰলৈ ডাউনল’ড হ’ব।

পদক্ষেপ ৪: এটা নতুন ব্ৰাঞ্চ (branch) বনাওক

কেতিয়াও প্ৰধান ব্ৰাঞ্চত (main branch) পোনে পোনে সালসলনি নকৰিব। এটা নতুন ব্ৰাঞ্চ বনাওক: git checkout -b my-first-contribution

পদক্ষেপ ৫: আপোনাৰ সালসলনিসমূহ কৰক

আপোনাৰ ক’ড এডিটৰত প্ৰকল্পৰ ফ’ল্ডাৰটো খোলক। এটা সৰু, নিৰ্দিষ্ট পৰিৱৰ্তন কৰক — কোনো বানান ঠিক কৰক, এটা অনুবাদ যোগ কৰক, এটা বাক্য উন্নত কৰক বা নথিপত্ৰ আপডেইট কৰক।

পদক্ষেপ ৬: আপোনাৰ পৰিৱৰ্তনসমূহ ষ্টেজ (stage) আৰু কমিট (commit) কৰক

লিখক: git add . তাৰ পিছত git commit -m “Add my first contribution” কমিট মেছেজবোৰ সদায় স্পষ্টকৈ লিখিব — ই প্ৰকল্প পৰিচালনাকাৰীসকলক আপোনাৰ পৰিৱৰ্তনসমূহ বুজাত সহায় কৰে।

পদক্ষেপ ৭: আপোনাৰ ব্ৰাঞ্চটো গিটহাবলৈ পুচ (push) কৰক

git push origin my-first-contribution

পদক্ষেপ ৮: এটা পুল ৰিকুৱেষ্ট খোলক

গিটহাবত আপোনাৰ ফৰ্ক কৰা ৰিপ’জিটৰীটোলৈ যাওক। এটা স্পষ্ট শীৰ্ষক আৰু বিৱৰণৰ সৈতে এটা পুল ৰিকুৱেষ্ট খোলক। পৰিচালনাকাৰীসকলে আপোনাৰ কাম পৰীক্ষা কৰিব।

নতুন শিকাৰুৱে কৰা সাধাৰণ ভুলসমূহ

  • কাম আৰম্ভ কৰাৰ আগতে শেহতীয়া পৰিৱৰ্তনসমূহ পুল (pull) কৰিবলৈ পাহৰি যোৱা।
  • ব্ৰাঞ্চ নোখোলাকৈ পোনে পোনে main ব্ৰাঞ্চলৈ পুচ কৰা।
  • অস্পষ্ট PR (পুল ৰিকুৱেষ্ট) বিৱৰণ লিখা।
  • এটা PR-ত বহুত বেছি পৰিৱৰ্তন কৰা।
  • পৰিচালনাকাৰীসকলে সংশোধন বিচাৰিলে নিৰাশ হোৱা।

আপুনি জমা দিয়াৰ পিছত কি হয়

এজন পৰিচালনাকাৰীয়ে আপোনাৰ পুল ৰিকুৱেষ্টটো পৰীক্ষা কৰিব। এবাৰ মাৰ্জ (merge) হৈ যোৱাৰ পিছত, আপুনি এতিয়া এজন অ’পেন চৰ্চ কণ্ট্ৰিবিউটৰ (open-source contributor)!

সহায়ৰ বাবে AI ব্যৱহাৰ কৰা

AI সঁজুলিবোৰে আপোনাক ক’ড বুজাত, কমিট মেছেজ লিখাত বা ভুল (error) সমাধান কৰাত সহায় কৰিব পাৰে। কিন্তু জমা দিয়াৰ আগতে AI-য়ে লিখা ক’ড সদায় ভালদৰে পৰীক্ষা কৰি ল’ব।

Axomiya IT Labs Axomiya IT Labs Community-written · open source সম্প্ৰদায়ৰ দ্বাৰা লিখিত · মুক্ত-উৎস