MTT-GH-Fundamentals

This document contains the instructions for the MTT GH Fundamentals lab. The lab is designed to teach the basics of GitHub and how to use it to contribute to the MOC content used by MTTs.

The scenarios proposed in this lab are based on the real-life scenarios that MTTs face when contributing to the MOC content. It is composed of the following components:

• An Source Repo (also called "Upstream") that contains a simulated MOC content (https://github.com/MS-ESI/MTT-GH-Fundamentals). As mentioned on the learning material, the original repo is the source of truth for the content. It is the repo that contains the latest version of the content. The original repo is owned by the Content Owner (Content Devs in a real life scenario). As MTTs or learners, we can report issues and propose changes to the content by opening a PR in the original repo, but we are not allowed to change it directly.
• A Forked repo (also called "Origin") that contains a copy of the original repo. The forked repo is owned by the contributor (MTT in a real life scenario). The forked repo is used to make changes to the content and propose them to the original repo.

You could also involve a local clone (copy) of the repo in your local machine. This is not required for the lab, it will try to teach the easiest way to collaborate with GitHub, only using web interface tooling.

You can perfectly collaborate in the MOC content without cloning the repo to your local machine. You can use the GitHub web interface to open issues, create PRs, review PRs, etc. This is the most common way to collaborate in GitHub as MTTs.

Pre-requisites

• Make sure you have a GitHub account. If you don't have one, you can create one for free at https://github.com/join. Identify yourself as Microsoft MTT in your Profile (TODO guidelines?).
• Review the Learning material in ADD WEBSITE.

Repository Structure

The repository is composed of the following files/folders:

• README.md: This file. Contains the instructions for the lab.
• Instructions folder: Contains the instructions for the demo lab file we will modify .
  • media folder: Contains the images used in the instructions.
  • WebApp-Lab.md: Instructions for the first demo lab.

Lab Instructions

• Lab 1 - Create a GH Issue
• Lab 2 - Create a Pull Request (Beginner)
• Lab 3 - Create a Pull Request (Intermediate)
• Lab 4 - Review a Pull Request (Beginner)
• Lab 5 - Review a Pull Request (Intermediate)