Skip to content

Commit 74464d6

Browse files
committed
docs: Update 02 Getting Ready
1 parent 3a5c07b commit 74464d6

File tree

1 file changed

+32
-7
lines changed

1 file changed

+32
-7
lines changed

docs/02-getting-ready.md

Lines changed: 32 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,25 +2,37 @@
22

33
Before you start using Git you will need some software to be installed.
44

5+
## Windows Users
6+
57
For Windows users the combination is one of:
68

79
- Microsoft Terminal and Git-SCM, or
810
- Microsoft Terminal and Laragon
911

12+
## MacOS Users
13+
1014
For MacOS users then either:
1115

1216
- iTerm2 & Git, or
1317
- Warp & Git
1418

1519
Mac users are able to install Git via the Git-SCM installer or via homebrew.
1620

21+
## Linux Users
22+
1723
For Linux users:
1824

1925
- Git
2026
Linux users should find git installed, if not use the package manager appropriate for your version of Linux.
2127

2228
## Windows Installations
2329

30+
On your personal Windows systems, our recommendation is to install the following:
31+
- Windows Terminal
32+
- Laragon
33+
34+
To update the version of Git to the latest, we have notes in an FAQ on the SQuASH Helpdesk.
35+
2436
### Microsoft Terminal Installation
2537

2638
This is a great way to interact with the command line.
@@ -29,23 +41,33 @@ Open the Microsoft Store, and search for "Microsoft Terminal".
2941

3042
Install the "Microsoft Terminal" version and not the preview.
3143

44+
45+
### Laragon Installation
46+
47+
Download the Full Installer from https://laragon.org/download/index.html.
48+
49+
Run the installer and accept the defaults.
50+
51+
This places Laragon in the folder `c:\Laragon`.
52+
3253
### Git Installation
3354

34-
Easiest way is to download and use the Git SCM installer:
55+
If you have Laragon installed, you do not need to install using the Git-SCM method as it already is part of the Laragon install. You will find it in `C:\Laragon\bin\git` on your machine. At TAFE it may be in the `c:\ProgramData\Laragon\bin\git` folder.
56+
57+
If you wish to install Git anyway, you may find the easiest way is to download and use the Git SCM installer:
3558

3659
https://git-scm.com/download/win
3760

3861
Use the 64 Bit version when possible.
3962

4063
Run the installer and accept the defaults.
4164

42-
### Laragon Installation
4365

44-
Download the Full Installer from https://laragon.org/download/index.html.
66+
## Updating Git
4567

46-
Run the installer and accept the defaults.
68+
For details on updating git, please check the SQuASH helpdesk FAQs.
4769

48-
This places Laragon in the folder `c:\Laragon`.
70+
---
4971

5072
# The CLI
5173

@@ -126,6 +148,7 @@ No matter what is shown, clear the content and enter the following in its place.
126148

127149
Click `SAVE` to save the changes
128150

151+
129152
### Visual flair (optional)
130153

131154
You may optionally customise the appearance of the terminal.
@@ -156,7 +179,9 @@ You will now have your terminal open and ready:
156179

157180
![](../assets/pasted-image-20240216111239.png)
158181

182+
183+
---
184+
159185
# Advanced Users
160186

161-
If you want to make your CLI look even cooler (more useful) then something like OhMyPosh (https://ohmyposh.dev/) may
162-
help.
187+
If you want to make your CLI look even cooler (more useful) then something like OhMyPosh (https://ohmyposh.dev/) may help.

0 commit comments

Comments
 (0)