Open source courseware for Git and GitHub

Overview

Build Status

GitHub Training Kit: Cheatsheets

We ❤️ Contributors Like You!

We’re eager to work with you, our user community, to improve these materials and develop new ones. Please check out our CONTRIBUTING guide for more information on getting started.

Looking for a resource that was once housed in training-kit?

This repository currently contains the Git and GitHub Cheatsheets. If you're looking for a project that used to be housed here, such as On-Demand training, reading lists, videos, and book recommendations, see this commit in the repository's history.

Projects Used in Training-Kit

Packaging for Viewing Behind Your Firewall

If you'd like to have a copy of the files to be served from a web server inside of your firewall, start by running script/package.

  1. Run script/package to create a release tarball. This will be in the format release-XXXXXXX.tgz for you to take wherever you want.
  2. To test this looks okay, create some folders mkdir -p test_site/kit.
  3. Untar the release, tar -xzf release-XXXXXXX.tgz -C test_site/kit.
  4. Switch into the test_site directory, cd test_site.
  5. View the site:
    • For python version 2.x, run: python -m SimpleHTTPServer
    • For python version 3.x, run: python -m http.server
    • Note: Some servers are more advanced than others and can handle redirects, smart recognition of .html files, etc

Site content is licensed under CC-BY-4.0. CC-BY-4.0 gives you permission to use the content for almost any purpose but does not grant you any trademark permissions, so long as you note the license and give credit, such as follows:

Content based on github.github.com/training-kit/ used under the CC-BY-4.0 license.

Code used to build and test the site as well as code samples on the site, if any, are licensed under CC0-1.0. CC0 waives all copyright restrictions but does not grant you any trademark permissions.

This means you can use the content and code in this repository except for GitHub trademarks in your projects.

When you contribute to this repository you are doing so under the above licenses.

Comments
  • Add beginner GraphQL course

    Add beginner GraphQL course

    This PR starts filling in the GraphQL beginner course outline. 🚧 WIP but 👀 @hollenberry @brianamarie @github/services-training we are ready to start writing copy with the understanding we'll need to iterate as we think through what the final chosen query and mutation look like.

    opened by hectorsector 32
  • Add spelling checks to content

    Add spelling checks to content

    Overview

    TL;DR Our tests don't currently check for spelling or other grammar like things. And they can! And they should! We have the power! 💪

    Questions

    • Does anyone have experience/knowledge of good libraries or ways to start?
    • It appears we will have to use npm alongside gems. Can we have a project.json file? Do we need one?

    Next Steps

    • ~~Remove writewell test, because it's erroring~~
    • [x] Mimic testing in successful repository
    • [x] Figure out how to call writewell succesfully in script/cibuild to check all .html and .md files

    Review

    Not ready for review yet, but I very much welcome help!

    cc/ @github/services-training and @github/services-engineering for help or expertise if willing 🙇

    Type: New Feature Skills Needed: Review/Testing 
    opened by brianamarie 30
  • Adapt format of 'Introduction to GitHub' to match 'GitHub Pages & Desktop'

    Adapt format of 'Introduction to GitHub' to match 'GitHub Pages & Desktop'

    Currently, the on-demand content for GitHub Pages and GitHub Desktop and the content for Introduction to GitHub have different formats.

    This PR introduces the topic for conversation - which format is better? Should we adapt the older content to match the newer format?

    I would ❤️ to have a conversation about this, and form our ideas as commits here to both continue brainstorming and progress. @github/services-training Thoughts on this?

    A few things I'd like to hear from @hollenberry in particular with his ✨ keen eye for data - If we decide to make this transition of format, how could we set ourselves up to gather meaningful data about which format is better received? How could that affect our other content? Is there already something in the 🔢 numbers we should be looking for to inform this decision?

    @github/services-training What do you think about moving the format of the desktop content to the introduction content? Does anyone want to ✋ for this?

    Final Steps for Shipping

    Other steps (non-blocker)

    • Create overlay with removed 'how to take a course' information - Happening in another PR #432
    opened by brianamarie 29
  • Support internationalization

    Support internationalization

    Objectives

    • Add language field to YAML frontmatter
    • Update template for HTML to definte lang attribute
    • Include language toggle/list for all docs translated

    Method

    • Copy content to ISO named sub-folders
    opened by jordanmccullough 26
  • Electron learning path

    Electron learning path

    This PR houses our work on the Electron learning path.

    The path is made up of 3 courses:

    1. Getting Started with Electron
    2. Packaging Apps
    3. Distributing your Apps
    opened by hectorsector 25
  • Replace ribbon with waving octocat

    Replace ribbon with waving octocat

    Overview

    TL;DR Replacing the recently added ribbon with a cute waving :octocat: .

    Questions

    • Where should we identify that we are using this open source code for the ribbon now that we aren't using something GitHub created: http://tholman.com/github-corners/

    Next Steps

    • Maybe create a page referencing where we get stuff like Minimal Mistakes and this ribbon

    Review

    It works for me locally, so some 👀 on this might be helpful.

    ☮️ ❤️ & :octocat:

    opened by beardofedu 25
  • Open Source Community Updates

    Open Source Community Updates

    With the recent move of our On Demand courses to Open Source, I think we have a great opportunity to fine tune some of the edges of our training-kit in a beginner-friendly way.

    Proposed Next Steps With Examples

    • [x] Update contributing.md with greater [detail] (https://github.com/exercism/exercism.io/blob/master/CONTRIBUTING.md) @crichID this is happening in #571
      • [x] In open sourcing these materials, are you open to people contributing changes to the core material itself, or is this more about giving them permission to customize and reuse it themselves? Either way, it'd be good to clarify.
    • [x] Update issue/PR templates for beginners @hollenberry
    • [x] Add labels based on proficiency, ability (technical writing, design, etc.) ( @brianamarie )
    • [x] Make a more welcoming README. @crichID
      • [x] Add image
      • [x] Add badge
      • [x] Add motivational messages.
      • [x] Include instructions for building On Demand
    • [x] Include Style Guide ( @hectorsector and @beardofedu ) this is happening in #436
      • [ ] Update SEO
    • [x] Slack/Gitter Channel
    • ~~Create Maintainer's Guide~~ [To be moved internally]
    • [x] Document the project's design, architecture, and directory structure (Mostly done in the README.md already, but can possibly be enhanced slightly)
    • [x] Create a Code of Conduct happening in #440

    Once we have a general agreement on the above steps, I'll break each of the above next steps out into separate issue threads with anticipated deadlines.

    Please feel free to comment if anything else under this bucket should be added or if any of the above should be adjusted! I'm hoping to 🚢 quickly, before we promote that we've moved these courses to Open Source.

    cc: @github/services-training , @kytrinyx

    opened by hollenberry 24
  • Training: Git Reset course

    Training: Git Reset course

    This Pull Request adds a short course (15 minutes) of hands-on learning the git reset command as well as the three modes (soft, mixed, and hard). Additionally reflog and cherry-pick are also introduced at the end of the course.

    Things to do [Updated: 12.27.16]

    • [x] New Outline with Welcome Page / Scenarios description
    • [x] Create new drop downs for Pushed / Didn't Push
    • [x] Scenario Intros (on actual scenario page)
      • [x] Committed Something on Accident
      • [x] Committed to Wrong Branch
      • [x] Commit Message Sucks
      • [x] Commit Broke EVERYTHING
      • [x] Too Many Commits!
    • [x] Steps for Pushed per Scenario
      • [x] Committed Something on Accident
      • [x] Committed to Wrong Branch
      • [x] Commit Message Sucks
      • [x] Commit Broke EVERYTHING
      • [x] Too Many Commits!
    • [x] Steps for Didn't Push per Scenario
      • [x] Committed Something on Accident
      • [x] Committed to Wrong Branch
      • [x] Commit Message Sucks
      • [x] Commit Broke EVERYTHING
      • [x] Too Many Commits!
    • [x] Tell Me Why per Scenario
      • [x] Committed Something on Accident
      • [x] Committed to Wrong Branch
      • [x] Commit Message Sucks
      • [x] Commit Broke EVERYTHING
      • [x] Too Many Commits!
    • [ ] Show Me How per Scenario
      • [ ] Committed Something on Accident
      • [ ] Committed to Wrong Branch
      • [ ] Commit Message Sucks
      • [ ] Commit Broke EVERYTHING
      • [ ] Too Many Commits!

    cc/ @github/services-training

    opened by beardofedu 18
  • First pages translated into Spanish

    First pages translated into Spanish

    Overview

    TL;DR

    As commented on #583, I've begun translating the learning path into Spanish.

    Questions

    <If relevant, write a list of questions that you would like to discuss related to the changes that you have made.>

    • Confirm file naming and paths.
    • Is it going to be possible to see something on the interface even if the translation is not complete?

    Next Steps

    <If incomplete, create a task list of items that are still being worked on within the Pull Request.>

    • [ ] Check if translation works well through the interface
    • [x] Keep translating learning path pages.

    Review

    <If complete, or ready for :eyes:, use @mentions for quick questions, specific feedback, and progress updates.>

    opened by mirenbz 17
  • Training Idea: GitHub API Development

    Training Idea: GitHub API Development

    While thumbing through some of our On-Demand Training, the question arose: Do we have GitHub API development training? From what I can gather, the answer is no. I'd like to propose adding a GitHub API training course to our offering so we can start to lower the barrier for developers to become GitHub integrators.

    A few questions we should probably answer out of the gate:

    1. Was there a reason we avoided the effort previously?
    2. Does this fit in with the initiatives of the training team for 2017?
    3. If so, is this better suited for a live format or on-demand?
    4. What is typically needed from other teams and individuals to create training content?

    CC @github/business-development @github/platform-interface

    opened by alrightjones 17
  • New pt_PT Cheat Sheet

    New pt_PT Cheat Sheet

    Hey,

    This pull request adds a new pt_pt cheat sheet as described in #357.

    • It includes the new .md cheat sheet
    • Adds two different folders for pt_PT and pt_BR (I know this might break some shortcuts, but keeping it as was is not right :cry:)

    Before asking for the project maintainers to review can you folks validate the translation and technicals? @shana, @nmdguerreiro?

    This is tricky to translate, a lot of the commands can't be fully explained in a one-liner (regardless of language). I kept some of the English terminology intact which I think is normal in Portuguese technical documents.

    This PR closes #357

    :octocat::heart:

    opened by bitoiu 16
  • Documentation unclear surrounding GitHub Desktop installation and its inclusion (or not) of Git

    Documentation unclear surrounding GitHub Desktop installation and its inclusion (or not) of Git

    Overview

    TL;DR Confusing and misleading information on a) whether or not Git is included as part of a GitHub Desktop install, and b) whether Git is already installed on "most versions of MacOS".

    Extra Detail

    • Information in para A conflicts with instruction in para B: "Installing GitHub Desktop will also install the latest version of Git if you don't already have it." vs "You must have Git installed before using GitHub Desktop."

    • Para C states "Most versions of MacOS will already have Git installed" whereas this is only true if Apple's Command Line Developer Tools are optionally installed (and which I suspect is less likely for a user looking at GitHub Desktop installation instructions).

    Screenshots

    Link A - https://github.com/github/training-kit/blob/master/git-guides/install-git.md#install-git-using-github-desktop Link B - https://docs.github.com/en/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop#part-3-configuring-git Link C - https://github.com/github/training-kit/blob/master/git-guides/install-git.md#install-git-on-mac

    Reasoning

    Testing suggests a local git install does not get installed as part of an official GitHub Desktop installation on macOS, however instead it seems some form of sandboxed implementation is included (?) as within the GitHub Desktop app itself it can perform git operations without any local git install being available. Suggest this needs to be clarified and documented, ie. if and/or when a separate local installation of git is required.

    opened by spikysimonw 0
  • Czech github git cheat sheet

    Czech github git cheat sheet

    Overview

    TL;DR

    • Translated the latest English version of the cheat sheet to Czech
    • Added the link to the translated resource on index.html

    Review I request the following friends to review my translation: @josefcernyawt @VitMalcharekAWT

    opened by AdamFiser 0
  • Remove 'make at least one commit' from Step 1

    Remove 'make at least one commit' from Step 1

    Overview

    TL;DR

    Step 4 already tells you to make at least one commit before pushing:

    Shape your history into at least one commit by using git add to stage the existing files, and git commit to make the snapshot.`

    Questions

    <If relevant, write a list of questions that you would like to discuss related to the changes that you have made.>

    Next Steps

    <If incomplete, create a task list of items that are still being worked on within the Pull Request.>

    Review

    <If complete, or ready for :eyes:, use @mentions for quick questions, specific feedback, and progress updates.>

    opened by ilovehackathons 0
  • Bump tzinfo from 1.2.9 to 1.2.10

    Bump tzinfo from 1.2.9 to 1.2.10

    Bumps tzinfo from 1.2.9 to 1.2.10.

    Release notes

    Sourced from tzinfo's releases.

    v1.2.10

    TZInfo v1.2.10 on RubyGems.org

    Changelog

    Sourced from tzinfo's changelog.

    Version 1.2.10 - 19-Jul-2022

    Commits
    • 0814dcd Fix the release date.
    • fd05e2a Preparing v1.2.10.
    • b98c32e Merge branch 'fix-directory-traversal-1.2' into 1.2
    • ac3ee68 Remove unnecessary escaping of + within regex character classes.
    • 9d49bf9 Fix relative path loading tests.
    • 394c381 Remove private_constant for consistency and compatibility.
    • 5e9f990 Exclude Arch Linux's SECURITY file from the time zone index.
    • 17fc9e1 Workaround for 'Permission denied - NUL' errors with JRuby on Windows.
    • 6bd7a51 Update copyright years.
    • 9905ca9 Fix directory traversal in Timezone.get when using Ruby data source
    • Additional commits viewable in compare view

    Dependabot compatibility score

    Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.


    Dependabot commands and options

    You can trigger Dependabot actions by commenting on this PR:

    • @dependabot rebase will rebase this PR
    • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
    • @dependabot merge will merge this PR after your CI passes on it
    • @dependabot squash and merge will squash and merge this PR after your CI passes on it
    • @dependabot cancel merge will cancel a previously requested merge and block automerging
    • @dependabot reopen will reopen this PR if it is closed
    • @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
    • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
    • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
    • @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
    • @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
    • @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
    • @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language

    You can disable automated security fix PRs for this repo from the Security Alerts page.

    dependencies 
    opened by dependabot[bot] 0
  • Adjustments typos translation and fix error link

    Adjustments typos translation and fix error link

    Overview

    TL;DR

    • Fixing typo in pt-BR translation of git diff command
    • Replacing link that was returning a 404 page with no content anchored to the correct location
    opened by ThesllaDev 0
  • Brianamarie/ci additions

    Brianamarie/ci additions

    Overview

    TL;DR

    Questions

    <If relevant, write a list of questions that you would like to discuss related to the changes that you have made.>

    Next Steps

    <If incomplete, create a task list of items that are still being worked on within the Pull Request.>

    Review

    <If complete, or ready for :eyes:, use @mentions for quick questions, specific feedback, and progress updates.>

    opened by azurecloud07 0
Releases(1.8.0)
Owner
GitHub
How people build software.
GitHub
A fast Perforce to Git conversion tool written in C++ using Perforce Helix Core C++ API and Libgit2

P4 Fusion A fast Perforce depot to Git repository converter using the Helix Core C/C++ API as an attempt to mitigate the performance bottlenecks in gi

Salesforce 51 Sep 16, 2022
Standardise code formating for cmake projects with git and clang-format

git-cmake-format This project aims to provide a quick and easy way to integrate clang-format into your CMake project hosted in a git repository, it co

Kenneth Benzie 47 Apr 14, 2022
Not a big fan of git. May create a nicer repo in the future.

os My x86-64 hobby operating system. Cooperative multitasking system with no user-mode support, everything runs on ring 0 (for now). Packed with a rea

tiagoporsch 13 Sep 9, 2022
This is the git repository for the FFTW library for computing Fourier transforms (version 3.x), maintained by the FFTW authors.

This is the git repository for the FFTW library for computing Fourier transforms (version 3.x), maintained by the FFTW authors.

FFTW 2.2k Sep 19, 2022
ncurses Git mirror

------------------------------------------------------------------------------- -- Copyright 2020,2021 Thomas E. Dickey

Repo mirrors 288 Sep 12, 2022
The official Allegro 5 git repository. Pull requests welcome!

Welcome to Allegro! Allegro is a cross-platform library mainly aimed at video game and multimedia programming. It handles common, low-level tasks such

Allegro 1.5k Sep 22, 2022
File path converter for Windows & Git Bash

windows-git-bash-path-converter Motivation Made this because it was so mad to convert path between Windows and Git Bash How to use Windows file path t

Jooho Lee 3 Mar 15, 2022
Flight rules for git

Flight rules for Git ?? English ∙ Español ∙ Русский ∙ 简体中文∙ 한국어 ∙ Tiếng Việt ∙ Français ∙ 日本語 What are "flight rules"? A guide for astronauts (now, pr

Kate Hudson 39.3k Sep 21, 2022
legacy Botnets source code Forked from github.com/malwares

Legacy-Botnets-Source-Code-Collection github.com/malwares None of these were made by me and I take no resonsibility for anything done with the code. T

Mohammed amine guesmi 14 Sep 10, 2022
Open-source and open-hardware scientific RPN calculator

OpenRPNCalc Open-source and open-hardware scientific RPN calculator Introduction OpenRPNCalc is a scientific calculator based on STM32 microcontroller

Anton Poluektov 139 Jul 20, 2022
A fully-functional open source and open hardware mechanical USB computer keyboard with only three keys!

threeboard threeboard is a fully-functional open source and open hardware mechanical USB computer keyboard with only three keys. It supports multiple

Conor Taylor 98 Aug 17, 2022
Open Source Cheat for Apex Legends, designed for ease of use. Made to understand reversing of Apex Legends and respawn's modified source engine as well as their Easy Anti Cheat Implementation.

Apex-Legends-SDK Open Source Cheat for Apex Legends, designed for ease of use. Made to understand reversing of Apex Legends and respawn's modified sou

null 101 Sep 5, 2022
Sourcetrail - free and open-source interactive source explorer

Sourcetrail Important Note: This project was archived by the original autors and maintainers of Sourcetrail by the end of 2021. If you want to know mo

Coati Software 12.9k Sep 24, 2022
Single source file ASTC texture decompression in C++ (derived from Google's open source Android project)

astc_dec astc_dec is a single source file ASTC texture decompressor with the Apache 2.0 license, derived from Google's open source Android sources. Th

Rich Geldreich 29 Jul 19, 2022
It is a Simple Telegram Bot, which will listen to GitHub Webhook and inform via Telegram

GitHub-Webhook-Bot ?? Simple Telegram Bot, which will listen to GitHub Webhook and inform via Telegram Setting Up Config ✍ Go to src/helper.h ---> Her

GautamKumar 32 Jun 19, 2022
Linux System Optimizer and Monitoring - https://oguzhaninan.github.io/Stacer-Web

Linux System Optimizer and Monitoring Reviews Required Packages curl, systemd PPA Repository (for ubuntu) sudo add-apt-repository ppa:oguzhaninan/stac

Oguzhan Inan 8k Sep 23, 2022
CQC (Charmed Quark Controller) a commercial grade, full featured, software based automation system. CQC is built on our CIDLib C++ development system, which is also available here on GitHub.

The CQC Automation System What It Is CQC is a commercial quality, software based automation system, suitable for residential or commercial application

Dean Roddey 59 Aug 17, 2022
This was the first ever Computer Science project that I made back in Class XII (2016). I thought I should upload it on GitHub so that it does not get lost. :)

First Ever Project This was the first ever Computer Science project that I made back in Class XII (2016). I thought I should upload it on github so th

Kshitiz Srivastava 3 Jun 7, 2021
matrix-04-decasanova-odonnell-westburg created by GitHub Classroom

One Week Review Research Question: What is SIMD, OMP, and MPI? What are the differences between them? Single Instruction Multiple Data (SIMD) is a par

null 1 Oct 27, 2021