GitHub 101 for contributors to canada-ca repositories

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...

thomasgohard/github101.md