Skip to content

fix(site): remove the Windows release claim and correct the catalog FAQ - #394

Open
ktn-jamf wants to merge 1 commit into
mainfrom
claude/webpage-capabilities-audit-5725c4
Open

ktn-jamf wants to merge 1 commit into
mainfrom
claude/webpage-capabilities-audit-5725c4

Conversation

@ktn-jamf

Copy link
Copy Markdown
Collaborator

Summary

The showcase site made two claims that are not true. This PR corrects them.

No Windows release binary

The install card on the site and the generated llms.txt said that GitHub Releases ship a Windows binary. No release has a Windows asset. To check a release, run gh release view <tag> --json assets. Both places now name macOS and Linux only.

How current the catalog is

The FAQ answer "How current is this catalog?" and the catalog heading said that the catalog is generated on every merge to main. That is not how the deploy works:

  • .github/workflows/deploy-site.yaml builds the CLI from the latest release tag. From main, it takes only the site files, the site generator, and internal/commands/groups.go. A command merged after a release appears only with the next release.
  • transformCommands in generator/site/main.go marks as New the commands that the previous deploy did not have. It keeps that list while the version stays the same. A release that adds no commands clears every New tag.

The visible FAQ, its FAQPage JSON-LD copy, and the catalog heading now say this.

Not changed

  • The JSON-LD operatingSystem field still lists Windows. This field says that the CLI runs on Windows, not that a release binary exists. GOOS=windows go build ./cmd/jamf-cli succeeds, and go install is a Windows install path.
  • README.md still says that the site is "Auto-updated on every merge." A fix for this sentence is outside the scope of this PR.

Verification

  • go test ./generator/site/
  • make verify-site
  • make verify-site-output. This target also checks that the visible FAQ matches the FAQPage JSON-LD.
  • make site, then a check of the page in a browser.

🤖 Generated with Claude Code

No GitHub release ships a Windows binary. The install card and llms.txt
said that one does. They now name macOS and Linux only. The JSON-LD
operatingSystem field does not change, because the CLI builds for
Windows and go install is a Windows install path.

The FAQ and the catalog heading said that the catalog is generated on
every merge to main. The deploy workflow builds the CLI from the latest
release tag, so a command merged after a release appears only with the
next release. The New tag marks the commands that the latest release
added, and a release that adds none clears every tag. The FAQ, its
FAQPage JSON-LD copy, and the heading now say this.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@ktn-jamf
ktn-jamf enabled auto-merge (squash) September 25, 2026 16:40

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants