Skip to content

docs: correct README signing, updater, and download claims for first release - #116

Merged
joelst merged 1 commit into
mainfrom
docs/readme-release-accuracy
Sep 14, 2026
Merged

joelst merged 1 commit into
mainfrom
docs/readme-release-accuracy

Conversation

@joelst

@joelst joelst commented Sep 14, 2026

Copy link
Copy Markdown
Owner

Follow-up to #115. The README pitch, tables, and screenshots are unchanged — this fixes statements that were inaccurate, most of them in the direction of underselling Flint, plus one dead download target.

What was wrong

Claim Reality
"Self-signed installers can trigger SmartScreen / Gatekeeper warnings" Windows installers carry a public-trust Authenticode signature via Azure Trusted Signing and validate against the Microsoft-managed root on any machine. Only macOS is unsigned. The README was discarding the strongest trust signal the project has.
"Code signing / updater keys may still be operator-configured for public releases" Stale. The updater pubkey and endpoint are configured and pass verify:release.
"In-app updater tracks the latest GitHub release" Wrong for 0.7.0 — releases/latest skips prereleases, so the updater will not offer it. This also contradicted the note added to CHANGELOG.md in #115.
Status link → releases/latest 404s on the API; redirects to an empty releases index in a browser. Now points at /releases.
"Install a build … when available" Hedge dropped now that 0.7.0 ships.

Also added

  • Badges — CI, release (include_prereleases, so it picks up 0.7.0), platforms, license. A repo with no badges and no releases reads as unlaunched regardless of the copy quality.
  • A "0.7.0 is Flint's first public release" line in Status.

The SmartScreen point is kept but corrected: public trust removes the "unknown publisher" prompt, though a new publisher identity can still accumulate reputation over early downloads. That is accurate rather than alarming.

Verification

  • npm run verify:markdown-links — 135 relative links across 28 files
  • Changeset uses empty frontmatter, matching the existing doc changesets; bumps nothing, so the already-set 0.7.0 is untouched

🤖 Generated with Claude Code

…release

The README understated Flint's trust posture and pointed at a dead download
target.

- "Self-signed installers can trigger SmartScreen / Gatekeeper warnings"
  described Windows as self-signed. Windows installers carry a public-trust
  Authenticode signature issued through Azure Trusted Signing and validate
  against the Microsoft-managed root with no certificate to install. Only
  macOS is unsigned; the caveat now says so.
- "Code signing / updater keys may still be operator-configured" was stale.
  The updater pubkey and endpoint are configured and pass verify:release.
- "In-app updater tracks the latest GitHub release" is wrong for 0.7.0.
  releases/latest skips prereleases, so the updater will not offer it. Match
  the note added to CHANGELOG in #115.
- The Status link pointed at releases/latest, which 404s on the API and
  redirects to an empty releases index. Point at /releases and drop the
  "when available" hedge now that 0.7.0 ships.

Also add CI, release, platform, and license badges, and state that 0.7.0 is
the first public release.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings September 14, 2026 03:18

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The README says installers are available, but no 0.7.0 release assets are currently published.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

Documentation-only update correcting Flint 0.7.0 release, signing, updater, and download claims.

Changes:

  • Updated README release, signing, updater, and installation guidance.
  • Added project status badges and first-release messaging.
  • Added an empty documentation changeset.
File summaries
File Reviewed changes
README.md Updates release status, signing, updater, download, and limitation documentation.
.changeset/docs-readme-release-accuracy.md Records the documentation-only change without a version bump.
Review details
  • Files reviewed: 2/2 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md
@joelst
joelst merged commit 4c456a7 into main Sep 14, 2026
10 checks passed
@joelst
joelst deleted the docs/readme-release-accuracy branch September 14, 2026 03:24
joelst added a commit that referenced this pull request Sep 14, 2026
…nClaw (#117)

* feat(integrations): surface the WSL2 mirrored-networking step for OpenClaw

Flint already ships a complete one-click fix for this in Settings -> Network ->
WSL clients: it detects WSL presence and mode, writes .wslconfig with a backup,
and offers the WSL restart. The problem was finding it.

The pointer lived in the OpenClaw card's `limitations` array, which renders only
after clicking "Show limitations & docs". WSL2's default NAT mode gives the VM
its own loopback, so a copied snippet fails with a connection error and the
remedy is behind a disclosure nobody expands when things are already not
working. That is the most likely first-run failure for OpenClaw on Windows, and
OpenClaw is a headline integration for this release.

Move the caveat into the card description so it is visible without expanding
anything, and reduce the limitations entry to the manual NAT alternative so the
card does not state it twice. Data-only change to the integrations catalog; no
component or runtime changes.

Also document the setting in the user guide: a WSL clients row in the network
table, a subsection explaining why loopback fails under NAT, and a
troubleshooting row. Corrects the guide's stale "self-signed builds" line in
passing, matching the README fix in #116 — Windows installers are publicly
trusted, though a new publisher identity can still draw a SmartScreen prompt.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
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