markdown source builds

Auto-generated via {sandpaper}
Source  : 6e2cfa5
Branch  : main
Author  : Elizabeth McAulay <stassewright@gmail.com>
Time    : 2023-10-17 23:15:58 +0000
Message : Merge pull request #152 from tobyhodges/add-2fa-setup

update GitHub account setup instructions

Author: actions-user

md5sum.txt

@@ -12,5 +12,5 @@
 "instructors/instructor-notes.md" "a45553efc112e3823f231cc16c2da968" "site/built/instructor-notes.md" "2023-04-21"
 "learners/discuss.md" "95bb205074ca2133f2001f99bb405179" "site/built/discuss.md" "2023-10-17"
 "learners/reference.md" "523a1e2ffd0aa0ef631151bcec384665" "site/built/reference.md" "2023-04-21"
-"learners/setup.md" "a797cd36f109f7c412ad2227fa13525f" "site/built/setup.md" "2023-04-21"
+"learners/setup.md" "b6128d6d1214aeaf72d4deda093cb8bf" "site/built/setup.md" "2023-10-17"
 "profiles/learner-profiles.md" "60b93493cf1da06dfd63255d73854461" "site/built/learner-profiles.md" "2023-04-21"

setup.md

@@ -2,9 +2,49 @@
 title: Setup
 ---
 
-If you haven't done so already, to follow this lesson you will need to:
+## Installing Git
+
+Since several Carpentries lessons rely on Git, please see
+[this section of the workshop template][workshop-setup] for
+instructions on installing Git for various operating systems.
+
+- [Git installation on Windows][workshop-setup]
+- [Git installation on MacOS][workshop-setup]
+- [Git installation on Linux][workshop-setup]
+
+## Creating a GitHub Account
+
+You will need an account for [GitHub](https://github.com) to follow this lesson.
+
+1. Go to <https://github.com> and follow the "Sign up" link at the top-right of the window.
+2. Follow the instructions to create an account.
+3. Verify your email address with GitHub.
+4. Configure multifactor authentication (see below).
+
+### Multi-factor Authentication
+
+In 2023, GitHub introduced a requirement for 
+all accounts to have 
+[multi-factor authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/about-two-factor-authentication) 
+configured for extra security.
+Several options exist for setting up 2FA, which are summarised here:
+
+1. If you already use an authenticator app, 
+   like [Google Authenticator](https://support.google.com/accounts/answer/1066447?hl=en&co=GENIE.Platform%3DiOS&oco=0) 
+   or [Duo Mobile](https://duo.com/product/multi-factor-authentication-mfa/duo-mobile-app) on your smartphone for example, 
+   [add GitHub to that app](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-totp-mobile-app).
+2. If you have access to a smartphone but do not already use an authenticator app, install one and 
+   [add GitHub to the app](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-totp-mobile-app).
+3. If you do not have access to a smartphone or do not want to install an authenticator app, you have two options:
+    1. [set up 2FA via text message](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages) 
+       ([list of countries where authentication by SMS is supported](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/countries-where-sms-authentication-is-supported)), or
+    2. [use a hardware security key](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key) 
+       like [Youbikey](https://www.yubico.com/products/yubikey-5-overview/) 
+       or the [Google Titan key](https://store.google.com/us/product/titan_security_key?hl=en-US&pli=1).
+
+The GitHub documentation provides [more details about configuring 2FA](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).
+
+[workshop-setup]: https://carpentries.github.io/workshop-template/install_instructions/#git
 
-1. Create a free [GitHub account](https://github.com/join) and confirm your email.
-2. Download and install Git for your operating system: [https://git-scm.com/downloads](https://git-scm.com/downloads) (*Note:* Git for Windows comes bundled with the Git BASH terminal that allows you to use UNIX-style commands on Windows)