← All exercises
Exercise 02

Your First Pull Request

The complete open-source workflow in one exercise

Duration 30–45 minutes
Difficulty Beginner
Prerequisites Exercise 01 — a working terminal, Git, and GitHub CLI.
Your First Pull Request

Overview

This chapter is a hands-on exercise. By the end of it, you'll have forked a real repository, created a branch, written a review of a book chapter, and submitted a pull request — the standard way open-source contributors propose changes.

This isn't a simulation. Your pull request will show up on GitHub for real people to read.

This is the open-source workflow. Every contribution to every major project in the world follows these same seven steps. You'll have done all of them by the end of this chapter.

— from the exercise

By the end of this exercise

Your own fork of The Agentic Crew repository on GitHub
A new branch with your changes isolated from main
A written review of a book chapter (your words, your opinions)
A pull request submitted to the original project — visible to real people

Terms you'll learn

Term What it means
Repository A project folder that Git is tracking — often called a "repo"
Fork Your personal copy of someone else's repository, stored on GitHub
Clone Downloading a repository from GitHub to your machine
Branch A parallel version of the project where you work without touching the main copy
Commit A saved snapshot of your changes, with a message describing what you did
Push Sending your commits from your machine up to GitHub
Pull Request A formal request to merge your branch into the original project

Sections in this exercise

01 What You'll Need
02 What's About to Happen
03 Fork and Clone the Book
04 Explore the Project
05 Create a Branch
06 Write Your Review
07 Commit and Push
08 Submit the Pull Request

You've just completed the workflow that powers every major open-source project in the world — fork, clone, branch, write, commit, push, pull request. Seven steps. You'll use them for the rest of this book, and for the rest of your career.