Skip to content

docs: clarify that name is the app name, not the AUMID - #605

Merged
MarshallOfSound merged 1 commit into
mainfrom
docs/clarify-name-aumid
Jul 1, 2026
Merged

docs: clarify that name is the app name, not the AUMID#605
MarshallOfSound merged 1 commit into
mainfrom
docs/clarify-name-aumid

Conversation

@claude

@claude claude Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Requested by Samuel Attard · Slack thread

Before / After

The typedoc for the name option claimed it was the "Windows Application Model ID (appId)", which is misleading.

  • Before: name — "Windows Application Model ID (appId)."
  • After: name — "The application name." with a note that this is not the Windows AUMID, and that the AUMID is derived from it as com.squirrel.<name>.<packageName>.

How

Docs-only change to the name field's JSDoc in src/options.ts. No behavioral change. The existing @defaultValue note (the package.json name field) is preserved.

This supersedes/feeds the fix originally drafted in electron/forge#4303 and resolves the docs concern in electron/forge#3118. Fixing it here upstream means Forge no longer needs a per-maker doc override, since it inherits these types.

The `name` option's typedoc described it as the "Windows Application
Model ID (appId)", which is misleading. `name` is the application name;
the Windows AUMID is derived from it as `com.squirrel.<name>.<packageName>`.
@MarshallOfSound
MarshallOfSound marked this pull request as ready for review June 29, 2026 20:34
@MarshallOfSound
MarshallOfSound requested a review from a team as a code owner June 29, 2026 20:34
@MarshallOfSound
MarshallOfSound merged commit 85cff2a into main Jul 1, 2026
14 checks passed
@MarshallOfSound
MarshallOfSound deleted the docs/clarify-name-aumid branch July 1, 2026 05:14
@electron-npm-package-publisher

Copy link
Copy Markdown

🎉 This PR is included in version 5.4.4 🎉

The release is available on:

Your semantic-release bot 📦🚀

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

Labels

3 participants