Add install README

[dotfiles.git] / doc / github.md

diff --git a/doc/github.md b/doc/github.md
index cae9634dba81fd50a0d505275618cfae891b347b..d0aec8426f19d4f9f5553b1ca5431cc2d47bcc5e 100644 (file)
--- a/doc/github.md
+++ b/doc/github.md
@@ -28,4 +28,39 @@
 
        ```powershell
        gh auth login
+       ```
+
+## Setup PowerShell for GitHub
+
+1. Install PowerShell for GitHub
+
+       ```powershell
+       Install-Module -Name PowerShellForGitHub -Scope CurrentUser
+       Set-GitHubConfiguration -DisableTelemetry
+
+       ```
+
+1. Authorize PowerShell for GitHub
+
+  Generate a classic token at <https://github.com/settings/tokens?type=beta>
+  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.
+
+  Now run:
+  ```powershell
+  set-githubauthentication
+  ```
+  and paste the token into password, and set the username to 'Slartibarfast'.
+
+3. Clone my multi-repo helper scripts
+
+       ```powershell
+       cd ~/src
+       git clone git@github.com:uillinois-community/powershell-scripts.git
+       ```
+
+4. Review the available commands
+
+       ```powershell
+       get-command -module MarkDownGitHub
+       get-command -module AgileGitHub
        ```
\ No newline at end of file