(MAINT) Fix and update tstoy install info

Prior to this change, the install instructions for TSToy pointed to
a fictional URL. This change:

1. Moves the tstoy source from the `app` folder to `tstoy`, so that using
   `go install` pulls the application with the correct name. There is no
   way to set a canonical name for the executable when installed this way
   except by folder name.
1. Updates the build script for the `package` action to build and archive
   the application for every supported OS and add them to the `tstoy/latest`
   folder. This is a temporary work around until we can get a more canonical
   solution for "releasing" the fictional app on Github.
1. Updates the install instructions to enable users to select either option.
1. Makes minor improvements to the display for the TSToy about page.

Author: michaeltlombardi

.gitattributes

@@ -1,3 +1,5 @@
 * text eol=lf
-*.png binary
-*.gif binary
+*.png    binary
+*.gif    binary
+*.zip    binary
+*.tar.gz binary

.site/assets/styles/_custom.scss

@@ -0,0 +1,8 @@
+sl-tab-group.shell-completion {
+    sl-tab {
+        &::part(base) {
+            padding-top: 0.5rem;
+            padding-bottom: 0.5rem;
+        }
+    }
+}

docs/tstoy/about.md

@@ -15,9 +15,29 @@ manage the configuration files.
 
 ## Installing TSToy
 
-[Download the latest release][01] for your operating system. After you download the release
-archive, you need to expand the archive and add it to your PATH. You'll need the application while
-following any of the tutorials in this section.
+```````````tabs
+---
+id:        install-instructions
+placement: start
+---
+``````tab { name="From Archive" }
+[Download the latest release][t1] for your operating system. After you download
+the release archive, you need to expand the archive and add it to your `PATH`.
+You'll need the application while following any of the tutorials in this
+section.
+
+[t1]: https://github.com/PowerShell/DSC-Samples/tree/main/tstoy/latest
+``````
+
+``````tab { name="With Go" }
+If you have Go installed on your system, you can use `go install` to get the
+latest version of the application and install it to your `GOPATH`.
+
+```sh
+go install github.com/PowerShell/DSC-Samples/tstoy@latest
+```
+``````
+```````````
 
 <!-- Add tabbed examples for doing so -->
 
@@ -30,29 +50,44 @@ tstoy
 
 You can enable shell completions for the application to make interacting with it easier.
 
+```````````tabs
+---
+id: enable-shell-completions
+placement: start
+class: shell-completion
+---
+``````tab { name="Bash" }
 ```bash
 # bash
 tstoy completion bash --help
 source <(tstoy completion bash)
 ```
+``````
 
-```sh
+``````tab { name="fish" }
+```fish
 # fish
 tstoy completion fish --help
 tstoy completion fish | source
 ```
+``````
 
+``````tab { name="PowerShell" }
 ```powershell
 # PowerShell
 tstoy completion powershell --help
 tstoy completion powershell | Out-String | Invoke-Expression
 ```
+``````
 
+``````tab { name="ZSH" }
 ```zsh
 # zsh
 tstoy completion zsh --help
 source <(tstoy completion zsh)
 ```
+``````
+```````````
 
 ## TSToy configuration
 
@@ -106,7 +141,10 @@ tstoy show path machine
 tstoy show path user
 ```
 
-``````tabs { #command-output}
+``````tabs
+---
+id: command-output
+---
 ````tab { name="On Windows" }
 ```powershell
 tstoy show path
@@ -188,6 +226,3 @@ tstoy show --only machine,user
 Machine configuration: {}
 User configuration: {}
 ```
-
-<!-- Fictional URL -->
-[01]: https://github.com/MicrosoftDocs/DSC-Examples/releases/tag/app%2Fv1.0.0

go.work

@@ -1,6 +1,6 @@
 go 1.19
 
 use (
-	./app
+	./tstoy
 	./samples/go/resources/first
 )

netlify.toml

@@ -2,7 +2,7 @@
 base = ".site/"
 publish = "public"
 command = "../netlify.sh"
-ignore = "git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF . ./docs ./samples ./app"
+ignore = "git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF . ./docs ./samples ./tstoy"
 
 [context.production.environment]
 HUGO_VERSION = "0.116.1"

app/.gitignore renamed to tstoy/.gitignore

@@ -16,9 +16,9 @@ builds:
       - darwin
     ldflags:
       - -s -w
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.version={{.Version}}
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.commit={{.ShortCommit}}
-      - -X github.com/PowerShell/DSC-Samples/app/cmd.date={{.CommitDate}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.version={{.Version}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.commit={{.ShortCommit}}
+      - -X github.com/PowerShell/DSC-Samples/tstoy/cmd.date={{.CommitDate}}
 
 archives:
   - format: tar.gz
@@ -44,7 +44,6 @@ changelog:
     exclude:
       - '^docs:'
       - '^test:'
-
 # The lines beneath this are called `modelines`. See `:help modeline`
 # Feel free to remove those if you don't want/use them.
 # yaml-language-server: $schema=https://goreleaser.com/static/schema.json

app/.goreleaser.yaml renamed to tstoy/.goreleaser.yaml

@@ -16,12 +16,43 @@ function Build-Project {
     param(
         [switch]$All
     )
-    if ($All) {
-        goreleaser release --skip-publish --skip-announce --skip-validate --clean --release-notes ./RELEASE_NOTES.md
-    } else {
-        goreleaser build --snapshot --clean --single-target
+
+    begin {
+        [string[]]$Arguments = @(
+            '--clean'
+            '--snapshot'
+        )
+        $DistFolder   = "$PSScriptRoot/dist"
+        $LatestFolder = "$PSScriptRoot/latest"
     }
-    Get-Command "./dist/tstoy*/tstoy*" -ErrorAction Stop
+    process {
+        if ($All) {
+            $Arguments += @(
+                '--skip-publish'
+                '--skip-announce'
+                '--skip-validate'
+            )
+            goreleaser release @Arguments
+            
+            if (Test-Path $LatestFolder) {
+                Remove-Item -Path $LatestFolder/* -Force -Recurse
+            } else {
+                mkdir $LatestFolder
+            }
+
+            Get-ChildItem -Path $DistFolder -File
+            | Where-Object -FilterScript { $_.Name -match '\.(txt|tar\.gz|zip)'}
+            | Move-Item -Destination $LatestFolder
+        } else {
+            $Arguments += @(
+                '--single-target'
+            )
+            goreleaser build @Arguments
+            Get-Command "./dist/tstoy*/tstoy*" -ErrorAction Stop
+        }
+    }
+
+    end { }
 }
 
 switch ($Target) {