From 8eb05b0cde718e7e4d3cebf2b074e7d189974fb0 Mon Sep 17 00:00:00 2001
From: Taylor Silva <dev@taydev.net>
Date: Wed, 12 Jun 2024 10:51:40 -0400
Subject: [PATCH] incorporate feedback about fly install steps

Feedback from this comment:
https://github.com/concourse/concourse/discussions/7353#discussioncomment-4357034

Signed-off-by: Taylor Silva <dev@taydev.net>
---
 lit/docs/getting-started/quickstart.lit | 52 ++++++++++++-------------
 1 file changed, 24 insertions(+), 28 deletions(-)

diff --git a/lit/docs/getting-started/quickstart.lit b/lit/docs/getting-started/quickstart.lit
index 43472fd4..03131c9b 100644
--- a/lit/docs/getting-started/quickstart.lit
+++ b/lit/docs/getting-started/quickstart.lit
@@ -28,45 +28,41 @@
 \section{
     \title{Install Fly}
 
-    Next, install the \reference{fly-cli} by downloading it from the web UI and
-    \reference{fly-login}{login} to your local Concourse as the \code{test} user:
-
-    \titled-codeblock{Unix}{bash}{{
-    # MacOS
-    $ curl 'http://localhost:8080/api/v1/cli?arch=amd64&platform=darwin' -o fly \\
-        && chmod +x ./fly && mv ./fly /usr/local/bin/
-    # Linux
-    $ curl 'http://localhost:8080/api/v1/cli?arch=amd64&platform=linux' -o fly \\
-        && chmod +x ./fly && mv ./fly /usr/local/bin/
-
-    $ fly -t tutorial login -c http://localhost:8080 -u test -p test
-    logging in to team 'main'
+    Next, install the \reference{fly-cli} by downloading it from the web UI.
+    Following the install steps for your OS:
 
-    target saved
+    \titled-codeblock{Linux}{bash}{{
+    curl 'http://localhost:8080/api/v1/cli?arch=amd64&platform=linux' -o fly
+    chmod +x ./fly
+    mv ./fly /usr/local/bin/
     }}
 
-    \titled-codeblock{Powershell One-liner}{bash}{{{
-    # Windows (Powershell)
-    % $concoursePath = 'C:\concourse\'; mkdir $concoursePath; `
+    \titled-codeblock{MacOS}{bash}{{
+    curl 'http://localhost:8080/api/v1/cli?arch=amd64&platform=darwin' -o fly
+    chmod +x ./fly
+    mv ./fly /usr/local/bin/
+    }}
+
+    \titled-codeblock{Windows (Powershell One-liner)}{bash}{{{
+    $concoursePath = 'C:\concourse\'; mkdir $concoursePath; `
     [Environment]::SetEnvironmentVariable('PATH', "$ENV:PATH;${concoursePath}", 'USER'); `
     $concourseURL = 'http://localhost:8080/api/v1/cli?arch=amd64&platform=windows'; `
     Invoke-WebRequest $concourseURL -OutFile "${concoursePath}\fly.exe"
     }}}
 
-    \titled-codeblock{flyinstall.ps1}{bash}{{{
-    # -- Desired fly.exe location -----------
-    $concoursePath = 'C:\concourse\'
-    mkdir $concoursePath
+    Use \reference{fly-login}{\code{fly login}} to log into your local
+    Concourse as the \code{test} user:
 
-    # -- Sets User Env Variable -------------
-    [Environment]::SetEnvironmentVariable('PATH', "$ENV:PATH;${concoursePath}", 'USER')
+    \codeblock{bash}{{{
+    fly -t tutorial login -c http://localhost:8080 -u test -p test
+    }}}
 
-    # -- Sets System Env Variable -----------
-    # [Environment]::SetEnvironmentVariable("PATH", "$ENV:PATH;${concoursePath}", "MACHINE")
+    You've successfully logged in if you see the following output:
 
-    # -- Download fly.exe -------------------
-    $concourseURL = 'http://localhost:8080/api/v1/cli?arch=amd64&platform=windows'
-    Invoke-WebRequest $concourseURL -OutFile "${concoursePath}\fly.exe"
+    \codeblock{bash}{{{
+    logging in to team 'main'
+
+    target saved
     }}}
 
     You'll notice that every \code{fly} command in this tutorial has to have the