release: add instructions on how to use uploaded artifacts (#204)

* release: add instructions on how to use uploaded artifacts

* PULL_REQUEST_TEMPLATE: init

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+##### Description
+
+<!---
+Please include a short description of what your PR does and / or the motivation behind it
+--->
+
+##### Checklist
+
+- [ ] Formatted with `cargo fmt`
+- [ ] Built with `nix build`
+- [ ] Ran flake checks with `nix flake check`
+- [ ] Added or updated relevant tests (leave unchecked if not applicable)
+- [ ] Added or updated relevant documentation (leave unchecked if not applicable)
+- [ ] Linked to related issues (leave unchecked if not applicable)
+
+##### Validating with `install.determinate.systems`
+
+If a maintainer has added the `upload to s3` label to this PR, it will become available for installation via `install.determinate.systems`:
+
+```shell
+curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/pr/$PR_NUMBER | sh -s -- install
+```

.github/workflows/release-branches.yml

@@ -32,3 +32,14 @@ jobs:
           BRANCH="branch_${{ github.ref_name }}"
           GIT_ISH="$GITHUB_SHA"
           ./upload_s3.sh "$BRANCH" "$GIT_ISH" "https://install.determinate.systems/nix/rev/$GIT_ISH"
+      - name: Install Instructions (Branch)
+        run: |
+          cat <<EOF
+          This commit can be installed by running the following command:
+
+          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/rev/$GITHUB_SHA | sh -s -- install
+
+          The latest commit from this branch can be installed by running the following command:
+
+          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/branch/${{ github.ref_name }} | sh -s -- install
+          EOF

.github/workflows/release-prs.yml

@@ -35,3 +35,14 @@ jobs:
           PR="pr_${{ github.event.pull_request.number }}"
           GIT_ISH="${{ github.event.pull_request.head.sha }}"
           ./upload_s3.sh "$PR" "$GIT_ISH" "https://install.determinate.systems/nix/rev/$GIT_ISH"
+      - name: Install Instructions (PR)
+        run: |
+          cat <<EOF
+          This commit can be installed by running the following command:
+
+          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/rev/${{ github.event.pull_request.head.sha }} | sh -s -- install
+
+          The latest commit from this PR can be installed by running the following command:
+
+          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/pr/${{ github.event.pull_request.number }} | sh -s -- install
+          EOF

.github/workflows/release-tags.yml

@@ -37,3 +37,10 @@ jobs:
           files: |
             artifacts/**
             nix-installer.sh
+      - name: Install Instructions (Tag)
+        run: |
+          cat <<EOF
+          This tag can be installed by running the following command:
+
+          curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix/tag/$GITHUB_REF_NAME | sh -s -- install
+          EOF