Pre-Work: Install software we'll be using

Instructions are not provided since they change frequently. The examples will be based on the Git Bash SCM shell command line, but are likely to be compatible with other operating systems with minor corrections.

Basically, it's your problem... err... an exercise for the reader to install all the below on your client system of choice.

Git command line client

The examples will show the use of the official Git client from https://git-scm.com/download/win.

Set your default name and E-mail to associate with any pushes.

git config --global user.name "Your Name"
git config --global user.email "Your E-mail"

This can be changed on a repository-by-repository basis.

Azure Az CLI client

Install the Azure CLI for Windows (or whatever OS you're using.)

Visual Studio Code

You can use another text editor, of course, but the examples will use Visual Studio Code. We may also end up using syntax-checking extensions which would be different in other editors.

Visual Studio Code also has nice Git integration. As always, the most annoying part will be credential management. We'll get to that later.

(Optional) mkdocs

This will let you run "mkdocs serve" to test your content locally. This is optional, but debugging locally can sometimes be useful.

Checkpoint 1: Test software is installed

Test Git command line client

git --version

Should return the git version.

git config --global user.name
git config --global user.email

Should show your user name and e-mail.

Test Azure Az CLI client

az --version

Returns version info like:

azure-cli                         2.52.0

core                              2.52.0
telemetry                          1.1.0

Extensions:
account                            0.2.1
alias                              0.5.2

Dependencies:
msal                            1.24.0b1
azure-mgmt-resource             23.1.0b2

Test Visual Studio Code

code --version

Returns a version, what looks like a SHA256 hash (commit ID?) and CPU architecture:

1.82.2
abd2f3db4bdb28f9e95536dfa84d8479f1eb312d
x64

(optional) Test Mkdocs is installed

mkdocs --version

Should return a version similar to:

mkdocs, version 1.4.1 from C:\Users\Steve.Bonds\AppData\Local\Programs\Python\Python310\lib\site-packages\mkdocs (Python 3.10)