Skip to content

Commit 769a185

Browse files
committed
markdown source builds
Auto-generated via `{sandpaper}` Source : 6387480 Branch : main Author : Seth Erickson <seth@crude.computer> Time : 2026-03-17 21:13:51 +0000 Message : Merge pull request #201 from alex-ball/patch-164 Update section on system and global configuration of Git
1 parent bfc62b5 commit 769a185

File tree

2 files changed

+26
-14
lines changed

2 files changed

+26
-14
lines changed

02-getting-started.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -39,27 +39,30 @@ On MacOS, without any configuration your output might look like this:
3939

4040
```output
4141
credential.helper=osxkeychain
42+
init.defaultbranch=main
4243
```
4344

44-
On Windows, without any configuration your output might look like this:
45+
If you followed our instructions for installing Git for Windows, your output might look like this:
4546

4647
```output
4748
diff.astextplain.textconv=astextplain
4849
filter.lfs.clean=git-lfs clean -- %f
4950
filter.lfs.smudge=git-lfs smudge -- %f
5051
filter.lfs.process=git-lfs filter-process
5152
filter.lfs.required=true
52-
http.sslbackend=openssl
53-
http.sslcainfo=C:/Program Files/Git/mingw64/ssl/certs/ca-bundle.crt
53+
http.sslbackend=schannel
5454
core.autocrlf=true
5555
core.fscache=true
56-
core.symlinks=false
56+
core.symlinks=true
57+
core.editor=nano.exe
5758
pull.rebase=false
58-
credential.helper=manager-core
59+
credential.helper=manager
5960
credential.https://dev.azure.com.usehttppath=true
60-
init.defaultbranch=main
61+
init.defaultbranch=master
6162
```
6263

64+
If you are using Linux or WSL 2 on Windows, you might not see any output at all.
65+
6366
If you have different output, then you may have your Git configured already. If you have not configured Git, we will do that together now.
6467
First, we will tell Git our user name and email.
6568

@@ -90,26 +93,35 @@ Let's also set our default text editor. A text editor is necessary with some of
9093
## Text editors
9194

9295
There are a lot of text editors to choose from, and a lot of people are enthusiastic about their preferences.
93-
Vi and Vim are popular editors for users of the BASH shell. If you will be using Git or the Shell with a group of people for a project or for work, asking for recommendations or preferences can help you pick an editor to get started with. If you already have your favorite, then you can set it as your default editor with Git.
96+
97+
Nano is a good choice because it works on Mac, Windows, and Linux; it runs directly in your shell; and has on-screen reminders of how to use it.
98+
If you followed our instructions for installing Git for Windows, it should already be your default editor.
99+
100+
Vi and Vim also run directly in the shell and have many powerful features, but are less beginner-friendly.
101+
102+
If you will be using Git or the Shell with a group of people for a project or for work, asking for recommendations or preferences can help you pick an editor to get started with. If you already have your favorite, then you can set it as your default editor with Git.
94103

95104
::::::::::::::::::::::::::::::::::::::::::::::::::
96105

97106
Any text editor can be made default by adding the correct file path and command line options (see [GitHub help](https://help.github.com/articles/associating-text-editors-with-git/)).
98-
However, the simplest `core.editor` value is `"nano -w"` on Mac, Windows, and Linux, which will run the Nano text editor directly in your shell.
99-
100-
For example:
107+
However, the simplest `core.editor` value is `"nano -w"`, which will run the Nano text editor directly in your shell.
108+
To select it, type the following into your shell:
101109

102110
```bash
103111
$ git config --global core.editor "nano -w"
104112
```
105113

106-
Lastly, we need to set the name of our default branch to `main.`
114+
Lastly, we need to make sure the name of our default branch is set to `main`, as that is what GitHub uses. To do this, type the following into your shell:
107115

108-
```bash
116+
```bash
109117
$ git config --global init.defaultBranch main
110118
```
111119

112-
The `init.defaultBranch` value configures git to set the default branch to `main` instead of `master`.
120+
::::::::::::::::::::::::::::::::::::::::: callout
121+
122+
You may already have seen a setting for `init.defaultbranch` when you looked at your configuration earlier, overriding Git's internal default. If your system configuration sets the default branch to `main`, you don't necessarily have to set it again yourself, but doing so protects you from any system-level changes.
123+
124+
::::::::::::::::::::::::::::::::::::::::::::::::::
113125

114126
### Creating a repository
115127

md5sum.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"contribute.md" "6f688a330994cf2ec8aab8076927dc05" "site/built/contribute.md" "2023-04-21"
66
"index.md" "773cf78e1289f5ca1461848f3c59dfdb" "site/built/index.md" "2023-04-21"
77
"episodes/01-what-is-git.md" "445007d28cfc4ea532840d493b6d10e6" "site/built/01-what-is-git.md" "2024-07-03"
8-
"episodes/02-getting-started.md" "b53f5633cc71d82f9fe6c9a41a2106bd" "site/built/02-getting-started.md" "2025-12-03"
8+
"episodes/02-getting-started.md" "aec7ccadf6546da998f0972df2241116" "site/built/02-getting-started.md" "2026-03-17"
99
"episodes/03-sharing.md" "2ebf04d7dbd6bb52bcd799fb62860d17" "site/built/03-sharing.md" "2025-08-14"
1010
"episodes/04-review.md" "97347d9170f42978d0b7a9bbb73dedf9" "site/built/04-review.md" "2025-11-18"
1111
"episodes/05-github-pages.md" "c58247de7c0afd95e6cd8e1d34f2b915" "site/built/05-github-pages.md" "2026-01-05"

0 commit comments

Comments
 (0)