thomasgohard/github101.md

## github101.md

      
    Raw
  

              github101.md
            
          
Overview

Where things are
How to navigate the GitHub interface
The files view vs. the Web view


Issues

How to submit an Issue

On the GitHub interface
Via the Web view


How to participate on an Issue

Filters

Open vs closed Issues
Author
Label
Assignee


Comments

Mentionning someone (@)
Referencing another Issue or a Pull Request (#)
Emojis (:)
Including files in comments


When to close an issue (etiquette)


Reviewing contributions

Pull Request index

Filters

Open vs closed Pull Requests
Author
Label
Reviews
Assignee


Pull Request screen

Comments (same as for Issues)
How to set assignees, reviewers, and labels
Can ignore the Commits and Checks tabs for now
Files changed tab

What is a diff

View settings

Regular vs. rich
Unified vs. split


Viewing the full file
Editing a file in a Pull Request
Adding inline comments on a Pull Request
Reviewing changes


Merging a contribution

The etiquette of merging
Checking reviewers have completed their review
Ensure checks are passing

Reviewing Travis logs for failed checks


What to do when there are conflicts
Squash and merge vs. Create a merge commit
Content vs. technical review

When to request a technical review


Contribute content

Forking the original repository
Creating branches

Before you start making changes
After you've made changes (but before you've committed your changes)


Navigating the content

GitHub file explorer
Web view


Editing the content

Markdown

Paragraphs
Headings
Lists
Tables
Images and other non-text content


Tagging
Front matter
HTML code fragments
Related guidelines


Identifying when changes were made and by whom
Advanced topics not covered

Adding and deleting files
Setting your own GH pages to preview your changes
Setting up checks on your fork
Resolving merge conflicts
Creating or editing a Playbook view


If something goes wrong...