doc/github.md

   1 ## Setup GitHub Key
   2
   3 1. Add new key to GitHub
   4
   5         ```sh
   6         cat ~/.ssh/id_rsa.pub
   7         ```
   8
   9         Visit <https://github.com/settings/keys>
  10
  11 1. Switch `dotfiles` to use SSH key access
  12
  13         Edit `.git/config`:
  14
  15         ```ini
  16         url = git@github.com:edthedev/dotfiles.git
  17         ```
  18
  19 ## Setup GitHub CLI
  20
  21 1. Install
  22
  23         ```powershell
  24         winget install --id GitHub.cli
  25         ```
  26
  27 2. Authorize
  28
  29         ```powershell
  30         gh auth login
  31         ```
  32
  33 ## Setup PowerShell for GitHub
  34
  35 1. Install PowerShell for GitHub
  36
  37         ```powershell
  38         Install-Module -Name PowerShellForGitHub -Scope CurrentUser
  39         Set-GitHubConfiguration -DisableTelemetry
  40
  41         ```
  42
  43 1. Authorize PowerShell for GitHub
  44
  45   Generate a classic token at <https://github.com/settings/tokens?type=beta>
  46   Select all the permissions that start with `read`, skip the ones I clearly don't care about. If you're not me, and reading this...use your judgement, and good luck.
  47
  48   Now run:
  49   ```powershell
  50   set-githubauthentication
  51   ```
  52   and paste the token into password, and set the username to 'Slartibarfast'.
  53
  54 3. Clone my multi-repo helper scripts
  55
  56         ```powershell
  57         cd ~/src
  58         git clone git@github.com:uillinois-community/powershell-scripts.git
  59         ```
  60
  61 4. Review the available commands
  62
  63         ```powershell
  64         get-command -module MarkDownGitHub
  65         get-command -module AgileGitHub
  66         ```