• 6 hours
  • Easy

Free online content available in this course.

course.header.alt.is_video

course.header.alt.is_certifying

Got it!

Last updated on 6/7/23

Work With a Remote Repository

Access a Remote Repository

Now that you know how to work on a local project, and have mastered the branch system, let’s look at how to access a remote repository and make a local copy of it.

I’ll explain how to do this in the video below. Try out the different steps under the video for yourself!

Imagine you’re working on a project with some friends. They’ve created a repository in GitHub. It’s now time for you to review the code and make some changes:

First, you need the URL of the remote repository. To access this, go to GitHub.

Access the remote repository you want to work on
Access the remote repository you want to work on
  • Click on the “Code” button to copy the repository, then on the HTTPS section.

Click on “Code” to copy the repository
Click on “Code” to copy the repository

And there’s the URL you need! Copy it to the clipboard.

  • Now go back to Git Bash and type in the following command:

git clone https://github.com/OpenClassrooms-Student-Center/7162856-G-rez-Git-and-GitHub.git

This repository name is far too long! I’d recommend creating a shortcut to save time.

  • Run the following command:

git remote add OC https://github.com/OpenClassrooms-Student-Center/7162856-G-rez-Git-and-GitHub.git

This command doesn’t copy the repository but tells the repository about the shortcut to the remote repository.

It’s as simple as that! Now you can go to the folder on your computer and access the code.

Update Your Local Repository

What if one of your friends adds changes to the main branch during the week, and you want to incorporate them into your local repository? You can use the command  git pull  :

git pull OC main

You should see something like this:

Result of the command git pull
Result of the command git pull

If so, that means the magic worked! 

All the files and folders in the repository should now be up to date in your current directory. The duplication takes place very quickly, as the files are compressed before transfer. This means you’ll receive them at the speed of light! Well, quickly, anyway!

You can now get to work on your developments without worrying about making mistakes. But first, let’s check a few details and have a look round our new repository.

Work on a Team With GitHub

I mentioned in previous chapters that GitHub is an excellent tool for working in a team. But how exactly does GitHub help developers work together?

GitHub is first and foremost an interface, and its role is to make it easy for developers to work together, which it does via its easy-to-use, fun, and simple design. So far, we’ve been looking at changes made to branches via command lines. If several people are working together on a project, it would be much more practical to be able to access the changes made without using the command line, wouldn’t it?

Check Your Project’s Branches

Let’s start by checking the different branches of the project—your colleagues might be working on new features. To see if they are, launch the command git branch -a  .

The-a option will list all branches, including those on the remote repository. You should see this:

* main 
new-version-css
update-readme

In the previous chapters, you used git merge to merge changes in your branch with the main branch.

But in a professional context, it’s a bit more complicated! 😀  When you’re working on a repository as part of a team, the main branch is often locked. You can’t push your code without it being checked. This means that you can’t merge your changes yourself!

What!? But what do I do then? I don’t have to ask for permission, do I?

Well, almost—you need to do what’s known as a pull request!

Make a Pull Request

A pull request is a GitHub feature you can use to ask the owners of a repository for permission to merge your changes with the main branch or any other branch you want to change.

If you’re creating a pull request, it means that you’ve first:

  1. Created a new branch.

  2. Sent your code to this same branch.

When these two conditions are met, a banner appears across the screen suggesting that you create a pull request:

The button “Compare & pull request” suggests that you create a pull request
The button “Compare & pull request” suggests that you create a pull request

Perfect!

The Open a pull request window appears
The Open a pull request window appears
  • Add a comment to explain the reasons for your changes.

In this case, you want to change the color of a tag. Therefore, you can add a comment: “Change h1 color from red to blue.”

GitHub uses a color code to show the changes made. Red lines mean something has been deleted, and green lines mean something has been added. Here, you can see that there has been a change on one line—red has been deleted and replaced by blue.

  • Click on Create pull request to validate the pull request.

  • Now you have a ready-to-use pull request!

You’ve created your pull request
You’ve created your pull request

Your pull request has been created and can be merged with the main branch. You can access it using this link.

Request a Code Review 

In large projects, your code might need to be reviewed and approved by other people working on the project before being merged with the main branch. This is called a code review. It helps pick up any errors and allows you to discuss choices and decisions or ask questions.

A code review allows you to discuss a pull request
A code review allows you to discuss a pull request

Now you know how to use GitHub for teamwork!

Watch the video below to go back over the different steps:

Let’s Recap!

  • In GitHub, you can access the URL of a remote repository.

  • Using git clone, you can make a local copy of a remote repository.

  • Using git remote add, you can give a repository a short name to make it easier to use.

  • Using git pull, you can duplicate a GitHub repository locally.

  • You can make a pull request to ask to merge your code with the main branch.

In this part, you discovered version management for development, and learned Git! Of course, sometimes you’ll make mistakes, but don’t worry—in the next part you’ll see how to fix them!

But first, a quiz! 

Example of certificate of achievement
Example of certificate of achievement