Conversation
miharp
marked this pull request as draft
September 13, 2026 12:09
Jig releases have shipped .deb and .rpm packages for Linux, a Windows zip, and a sha256sums.txt since v2.3.0, but the Installing Jig section only described the tarballs and go install. List what each release ships, add a Linux packages subsection that installs straight from the GitHub release asset URLs (curl then apt for Debian and Ubuntu, dnf with the URL on the Red Hat family), and show how to verify a download against the checksum file. A VERSION variable and a BASE variable for the release URL keep every command line short enough to read without scrolling the code block. The go install command also needs the /v2 module path. Without it, Go resolves @latest against the old module path and installs jig 1.5.0. Closes OpenVoxProject#482 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Signed-off-by: Michael Harp <mike@mikeharp.com>
miharp
force-pushed
the
docs/jig-install
branch
from
September 13, 2026 12:58
b488c12 to
0612812
Compare
miharp
marked this pull request as ready for review
September 13, 2026 13:01
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #482
The Installing Jig section only described the release tarballs and
go install. Since v2.3.0 every jig release also ships.deband.rpmpackages, a Windows zip, andsha256sums.txt.Changes to
docs/_ecosystem_8x/devkit/jig.md:VERSIONandBASEvariables, thencurl -LOplusapt install ./jig_${VERSION}_linux_amd64.debfor Debian/Ubuntu, anddnf install ${BASE}/jig_${VERSION}_linux_amd64.rpmfor the Red Hat family (dnf accepts URLs; apt does not). TheBASEvariable keeps each command line inside the code block's visible width instead of scrolling. Notes the binary lands in/usr/binand that there is no apt/dnf repository, so upgrades are the same steps with the next version.shasum -a 256 -c --ignore-missing sha256sums.txtcheck, and reworded the macOS Gatekeeper tip to say "macOS binaries" rather than "packages".go install github.com/voxpupuli/jig/v2@latest. jig'sgo.modisgithub.com/voxpupuli/jig/v2and the v1 tags still exist, so the old command resolves@latestto v1.5.0.Verification:
go installforms locally: the un-suffixed one produces a binary reportingjig@v1.5.0(no--versionflag); the/v2one reportsjig version v2.4.0.jig_2.4.0_linux_amd64.deb: contains/usr/bin/jigand/usr/share/doc/jig/LICENSE.shasum -a 256 -c --ignore-missing sha256sums.txtverifies the downloaded deb on macOS.VERSION,BASE,curl -LO): the deb matchessha256sums.txt, and the rpm URL built the same way returns 200. Thereleases/latest/download/shortcut does not work because the asset names include the version.*to match the file's existing bullet style).Upstream jig's own install docs have the same gap; tracked at voxpupuli/jig#96.
The page says there is no apt or dnf repository for jig. That is true today, but OpenVoxProject/openvox-release-infra#24 is building a
toolscomponent for the Go tools (jig, g10k, webhook-go, openvox-ca, openvoxview, gorge). Thetools-releasepackages and.repofiles are already on apt.voxpupuli.org and yum.voxpupuli.org, but the repository itself is still empty (the yumtools/baseurl returns 404 and there is notoolscomponent under the apt dists). Once packages land there, this section should switch to recommending the repository over the standalone downloads.Assisted by Claude.