Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions github/introduction-to-github/1-introduction.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ title: Introduction
metadata:
title: Introduction
description: Learn to use key GitHub features, including issues, notifications, branches, commits, and pull requests.
ms.date: 06/26/2020
ms.date: 08/28/2022
author: tpetchel
ms.author: thpetche
ms.topic: interactive-tutorial
ms.prod: learning-azure
durationInMinutes: 2
content: |
[!include[](includes/1-introduction.md)]
[!include[](includes/1-introduction.md)]
16 changes: 6 additions & 10 deletions github/introduction-to-github/includes/1-introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,12 @@ In this module, you learn to use key GitHub features, including issues, notifica

In this module, you will:

- Communicate with the project community in issues
- Manage notifications for project events
- Create branches to manage work in parallel
- Make commits to update project source
- Introduce changes with pull requests
- Deploy a web page to GitHub Pages
- Recognize the differences between Git and GitHub and the roles they play in the software development lifecycle
- Describe a repository fork and how it differs from a clone
- Explain the functionality of repository labels and where to apply them in issues and pull requests
- Recognize the differences between Git and GitHub
- Understand the basics of the following features of GitHub:
- Issues, notifications, branches, commits, pull requests, notifications, labels, actions, forks, and GitHub pages
- Learn how to:
- Create a branch, commit a file, open a pull request, and merge a pull request

## Prerequisites

- A GitHub account
- A GitHub account
9 changes: 3 additions & 6 deletions github/introduction-to-github/includes/2-what-is-github.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,5 @@
Here, we discuss the key GitHub features you use on a daily basis to manage and contribute to software projects.

## The GitHub flow

In addition to providing a platform for collaborative software development, GitHub also offers a workflow designed to optimize use of its various features. While this unit offers a cursory overview of important platform components, it's recommended that you first review [Understanding the GitHub flow](https://guides.github.com/introduction/flow/?azure-portal=true).

## Git and GitHub

As you work with **Git** and **GitHub**, you may wonder about the difference between the two.
Expand Down Expand Up @@ -65,7 +61,7 @@ To learn more about GitHub commits, see [Committing and reviewing changes to you

## Pull Requests

A **pull request** is the mechanism used to signal that the commits from one branch are ready to be merged into another branch. The developer submitting the **pull request** will often request one or more reviewers to verify the code and approve the merge. These reviewers have the opportunity to comment on changes, add their own, or use the pull request itself for further discussion. Once the changes have been approved (if approval is required), the pull request's source branch (the compare branch) may be merged in to the base branch.
A **pull request** is the mechanism used to signal that the commits from one branch are ready to be merged into another branch. The developer submitting the **pull request** will often request one or more reviewers to verify the code and approve the merge. These reviewers have the opportunity to comment on changes, add their own, or use the pull request itself for further discussion. Once the changes have been approved (if approval is required), the pull request's source branch (the compare branch) may be merged into the base branch.

:::image type="content" source="../media/2-pull-request.png" alt-text="GitHub pull requests provide a way to get commits from one branch into another branch." border="false":::

Expand Down Expand Up @@ -130,8 +126,9 @@ To learn more, see [Fork a repo](https://docs.github.com/en/free-pro-team@latest

:::image type="content" source="../media/2-github-pages.png" alt-text="GitHub Pages is a hosting engine available with your GitHub account. It can be used to host static sites generated from your repository." border="false":::

GitHub Pages sites for public repositories have been built and are deployed with GitHub Actions. GitHub Actions to build and deploy private and internal repositories are available as well, depending on your GitHub plan. You can include injecting secrets in your build process, gate deployments to require approvals before publishing, or add a build check to prevent bad commits from being deployed.
GitHub Pages sites for public repositories have been built and are deployed with GitHub Actions. You can use GitHub Actions to build and deploy private and internal repositories as well, depending on your GitHub plan. You can include injecting secrets in your build process, gate deployments to require approvals before publishing, or add a build check to prevent bad commits from being deployed.

GitHub Pages track deployments instead of builds. A source branch is not required and is at the discretion of a workflow’s triggers. A deployment is required in the context of an environment (`github-pages` by default). As a result, environment protection rules are the new security mechanism for limiting deployments.

To learn more, see [GitHub Pages](https://pages.github.com/?azure-portal=true).

18 changes: 7 additions & 11 deletions github/introduction-to-github/includes/5-summary.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,12 @@
In this module, you learned about the key features of GitHub, including issues, commits, and pull requests. You also used GitHub Pages to publish a public site based on the contents of your project.
In this module, you learned about the key features of GitHub, including issues, commits, and pull requests.

You learned about:

- Communicating with the project community in issues
- Managing notifications for project events
- Creating branches to manage work in parallel
- Making commits to update project source
- Introducing changes with pull requests
- Deploying a web page to GitHub Pages
- Differences between Git and GitHub and the roles they play in the software development lifecycle
- How a repository fork differs from a clone
- Repository labels and where to apply them in issues and pull requests
- Recognize the differences between Git and GitHub
- Understand the basics of the following features of GitHub:
- Issues, notifications, branches, commits, pull requests, notifications, labels, actions, forks, and GitHub pages
- Learn how to:
- Create a branch, commit a file, open a pull request, and merge a pull request

Now that you're familiar with the basics of GitHub, learn to [Upload your project by using GitHub best practices](/learn/modules/upload-project-github/).

Expand All @@ -24,4 +20,4 @@ Here are some links to more information on the topics we discussed in this modul
- [About the role of labels](https://docs.github.com/en/free-pro-team@latest/github/managing-your-work-on-github/about-labels?azure-portal=true)
- [GitHub Actions](https://docs.github.com/en/free-pro-team@latest/actions?azure-portal=true)
- [Fork a repo](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo?azure-portal=true)
- [Working with GitHub Pages](https://help.github.com/en/github/working-with-github-pages?azure-portal=true)
- [Working with GitHub Pages](https://help.github.com/en/github/working-with-github-pages?azure-portal=true)
11 changes: 5 additions & 6 deletions github/introduction-to-github/index.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,11 @@ title: "Introduction to GitHub"
summary: Learn to use key GitHub features, including issues, notifications, branches, commits, and pull requests.
abstract: |
In this module, you will:
- Communicate with the project community in issues
- Manage notifications for project events
- Create branches to manage work in parallel
- Make commits to update project source
- Introduce changes with pull requests
- Deploy a web page to GitHub Pages
- Recognize the differences between Git and GitHub
- Understand the basics of the following features of GitHub:
- Issues, notifications, branches, commits, pull requests, notifications, labels, actions, forks, and GitHub pages
- Learn how to:
- Create a branch, commit a file, open a pull request, and merge a pull request
prerequisites: |
- A GitHub account
iconUrl: /learn/achievements/github/introduction-to-github.svg
Expand Down