Skip to content

docs(windows): point install instructions at setup-windows.bat for MOTW#201

Merged
pdfinn merged 1 commit into
masterfrom
docs/windows-bat-unblock-flow
Jun 2, 2026
Merged

docs(windows): point install instructions at setup-windows.bat for MOTW#201
pdfinn merged 1 commit into
masterfrom
docs/windows-bat-unblock-flow

Conversation

@pdfinn
Copy link
Copy Markdown
Member

@pdfinn pdfinn commented Jun 2, 2026

Summary

v0.2.1 shipped PR #200, which made `setup-windows.bat` strip Mark-of-the-Web from the bundle on first run. But the install documentation still pointed at the old manual right-click-Properties-Unblock-before-extracting workaround — telling users to do work they no longer need to do, and (more importantly) failing to tell them that running `setup-windows.bat` is now load-bearing.

Changes

  • README.md — Windows install bullet and SignPath attribution paragraph rewritten around `setup-windows.bat` as the on-ramp.
  • release.yml — release-notes body (Windows GUI + headless Quick Start, Code signing section) updated to match. This propagates to every future release's GitHub release page.

The new Windows flow now reads consistently across both surfaces:

Extract the zip, double-click `setup-windows.bat` (it clears Mark-of-the-Web and configures an LLM backend), then double-click `InferNode.exe`.

Related

Test plan

  • Diff reviewed — only docs touched, no behavior change
  • release.yml YAML still well-formed (changes are inside the existing multi-line `body:` literal)
  • Merge → cut v0.2.2 patch release so the next published release-notes body reflects the new flow

🤖 Generated with Claude Code

v0.2.1 made setup-windows.bat strip Mark-of-the-Web from the bundle on
first run (PR #200), but the install documentation still pointed at the
manual right-click-Properties-Unblock-before-extracting workaround. The
new recommended flow on Windows is now simply:

  Extract → double-click setup-windows.bat → double-click InferNode.exe

Update both surfaces that describe Windows install:

- README.md
  - Windows install bullet — drop the manual Unblock step, lead with
    setup-windows.bat, explain why (.bat is the one file exempt from
    the MOTW launch gate, so it can unblock the rest).
  - SignPath attribution paragraph — replace "see the Windows install
    bullet above for the manual Unblock workaround" with
    "handled in the meantime by setup-windows.bat".

- .github/workflows/release.yml (release-notes body)
  - Windows (GUI) Quick Start — same flow.
  - Windows (headless) Quick Start — note the .bat is needed there too,
    since the console o.emu.exe is also MOTW-tagged.
  - Code signing section — drop the manual-Unblock reference.

The infernode.io site has a parallel update in pdfinn/infernode.io
PR #8 (winBody in en.ts + zh.ts).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@pdfinn pdfinn merged commit 65ca49c into master Jun 2, 2026
18 checks passed
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.

1 participant