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

edits to change SnarkyJS latest install suggestion and other CLI prompt fixes #437

Merged
merged 2 commits into from
Jun 21, 2023

Conversation

barriebyron
Copy link
Contributor

This PR includes:

  • Minor updates for language
  • Changes from the Slack convo making this the suggested command when an earlier version is detected:

npm install snarkyjs@latest

@barriebyron barriebyron added docs Improvements or additions to documentation enhancement New feature or request product-eng For tracking our team's issues labels Jun 21, 2023
@barriebyron barriebyron self-assigned this Jun 21, 2023
@@ -48,9 +48,9 @@ async function deploy({ alias, yes }) {
config.deployAliases = config?.networks;

if (hasBreakingChanges(installedCliVersion, latestCliVersion)) {
log(red(`You are using an old zkapp-cli version ${installedCliVersion}.`));
log(red(`You are using an earlier zkapp-cli version ${installedCliVersion}.`));
Copy link
Contributor Author

Choose a reason for hiding this comment

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

general advice in language is to use earlier instead of older
https://github.com/o1-labs/docs2/wiki/Word-list#earlier
image

and

image

(not sure we need to provide a version number since we detect the earlier version)

@@ -70,7 +70,7 @@ async function deploy({ alias, yes }) {
// Makes the step text green upon success, else uses reset.
const style =
state.submitted && !state.cancelled ? state.styles.success : reset;
return style('Which deploy alias would you like to deploy to?');
return style('Which deploy alias do you want to deploy to?');
Copy link
Contributor Author

Choose a reason for hiding this comment

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

"like" and "desire" are emotive, let's use imperative language for the prompts

@@ -137,7 +137,7 @@ async function deploy({ alias, yes }) {
return { smartContracts };
});

// Identify which smart contract should be deployed for this deploy alias.
// Identify which smart contract to be deployed for this deploy alias.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

we all want to use "should" but in technical situations, we want to avoid
see https://developers.google.com/style/word-list#letter-s
image

@@ -216,7 +216,7 @@ function kebabCase(str) {

/**
* Fetch an example & place in the `src` directory.
* @param {string} example Name of the example, as found in our Github repo.
* @param {string} example Name of the example, as found in our GitHub repo.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

yep! we misspell GitHub in many places in our docs and code (oof)

@barriebyron barriebyron merged commit f977c91 into main Jun 21, 2023
@barriebyron barriebyron deleted the snarky-latest branch June 21, 2023 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to documentation enhancement New feature or request product-eng For tracking our team's issues
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants