Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify Snaps CLI usage #1075

Merged
merged 3 commits into from
Jan 4, 2024
Merged

Clarify Snaps CLI usage #1075

merged 3 commits into from
Jan 4, 2024

Conversation

alexandratran
Copy link
Contributor

@alexandratran alexandratran commented Jan 4, 2024

The recommended Snaps quickstart method is to use @metamask/create-snap, which installs @metamask/snaps-cli for you when you create a new Snap. This PR clarifies the command required to run the documented CLI subcommands and options (yarn mm-snap ...), and also makes minor edits throughout the Snaps docs for clarity and consistency. Fixes #854.

@alexandratran alexandratran requested review from a team as code owners January 4, 2024 04:59
Copy link

github-actions bot commented Jan 4, 2024

Preview published: 854-snaps-cli

@alexandratran alexandratran requested a review from Mrtenz January 4, 2024 18:10
Copy link

github-actions bot commented Jan 4, 2024

Preview published: 854-snaps-cli

@alexandratran alexandratran requested a review from Montoya January 4, 2024 19:52
Copy link

github-actions bot commented Jan 4, 2024

Preview published: 854-snaps-cli

Copy link
Collaborator

@Montoya Montoya left a comment

Choose a reason for hiding this comment

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

See comments. Overall just one syntactical issue.

@alexandratran alexandratran requested a review from Montoya January 4, 2024 20:06
Copy link
Contributor

@joaniekube joaniekube left a comment

Choose a reason for hiding this comment

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

LGTM

@alexandratran alexandratran merged commit a764d1b into main Jan 4, 2024
6 checks passed
@alexandratran alexandratran deleted the 854-snaps-cli branch January 4, 2024 21:19
@@ -155,8 +148,9 @@ details the requirements of both `snap.manifest.json` and its relationship to `p
You might need to modify some manifest fields manually.
For example, if you change the location of the icon SVG file, you must update
`source.location.npm.iconPath` to match.
You can also use the [command line](../reference/cli/index.md) to update some fields for you.
For example, `mm-snap build` or `mm-snap manifest --fix` updates `source.shasum`.
You can also use the [Snaps CLI](../reference/cli/subcommands.md) to update some fields for you.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe... "You can also use ... to update some fields.

running `mm-snap manifest --fix` after creating your bundle.
You may also benefit from running `mm-snap eval` to detect any SES issues up front.
We recommend running [`yarn mm-snap manifest --fix`](../reference/cli/subcommands.md#m-manifest)
after creating your bundle to make sure your manifest `shasum` value is correct.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe... to make sure = to ensure


## Specify options

You can specify options:
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure if this format is necessary. Maybe... "You can specify options either in the configuration file (...) or on the command line using ...

Copy link
Contributor

@mjsmike62 mjsmike62 left a comment

Choose a reason for hiding this comment

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

LGTM. Just a couple suggested edits.

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.

Document Snaps CLI config format
5 participants