github / github/training-kit

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

オープン
#920 コメント 2 件 リアクション 2 件 担当者 0 名 GitHub で見る
主要言語
HTML
スター
5.1k
フォーク
4.5k
PR マージ指標
30日以内にマージされた PR はありません

説明

## 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](https://github.com/github/training-kit/blob/master/git-guides/install-git.md#install-git-using-github-desktop) conflicts with instruction in para [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): _"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](https://github.com/github/training-kit/blob/master/git-guides/install-git.md#install-git-on-mac) 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.

コントリビューションガイド

コントリビューションガイドを開く

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。