Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Your first contribution #2

Open
github-learning-lab bot opened this issue Jun 19, 2021 · 2 comments
Open

Your first contribution #2

github-learning-lab bot opened this issue Jun 19, 2021 · 2 comments

Comments

@github-learning-lab
Copy link

Introduction to GitHub flow

Now that you're familiar with issues, let's use this issue to track your path to your first contribution.

People use different workflows to contribute to software projects, but the simplest and most effective way to contribute on GitHub is the GitHub flow.

📺 Video: Understanding the GitHub flow


Read below for next steps

@github-learning-lab
Copy link
Author

Step 4: Create a branch

Let’s complete the first step of the GitHub flow: creating a branch 📖.

Creating a branch

Creating a branch

📺 Video: Branches

You just learned how to create a branch—the first step in the GitHub flow.

Branches are an important part of the GitHub flow because they allow us to separate our work from the main branch. In other words, everyone's work is safe while you contribute.

Tips for using branches

A single project can have hundreds of branches, each suggesting a new change to the main branch.

The best way to keep branches organized with a team is to keep them concise and short-lived. In other words, a single branch should represent a single new feature or bug fix. This reduces confusion among contributors when branches are only active for a few days before they’re merged 📖 into the main branch.


⌨️ Activity: Your first branch

  1. Download and open Visual Studio Code (referred to as VS Code) if you don't already have it.
  2. In VS Code, open the Command Palette using Ctrl+Shift+P on Windows, or Command ⌘+Shift+P on macOS. You can also follow VS Code's official documentation on cloning.
  3. Type: git clone and press Enter
    a screenshot of vs code with the command palette open
  4. Paste in the URL of the repository in the new window and press Enter:
    https://github.com/RAKamel/github-slideshow.git
  5. Select the location in which to save the repository and click Choose folder. Then, open the location you selected.
  6. The repository folder should now be open in your VS Code project. Click on main at the bottom left of the VS Code window. This will bring up the Command Palette with the commands related to Git branches.
    a screenshot of the Git branches in VS Code
  7. Click Create new branch and enter any branch name you'd like, such as my-slide. Then press Enter.
  8. When asked to select the ref to create the branch from, select main.
  9. Go to the Source Control view, click on the ellipsis (...) and select Push. Confirm the dialog box asking you to publish the branch.
    a screenshot of the source control view in VS Code

I'll respond when I detect a new branch has been created in this repository.

@RAKamel
Copy link
Owner

RAKamel commented Jun 19, 2021

Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant