docs: Added steps for using npm/npx locally to CONTRIBUTING.md

[AaronHamilton965]

Summary

We noticed there were no steps for using npm/npx locally on the CONTIBUTING.md file so we decided to add a new section that explained how to do this.

[wraithgar]

These suggestions seem quite overly prescriptive. The folder where things are checked out will vary by user (and in the case of git worktrees, with every branch) so aliases don't seem like the best suggestion.

node . and node . exec are the preferred ways to run npm and npm exec when working locally.

[wraithgar]

this is not an analog for npx. You'd want to run the bin directly or node . exec

[wraithgar]

same here, install is not the same as npx/npm exec

[rahulio96]

Appreciate the feedback, we made the appropriate changes.

We thought that having an npm install command instead of exec as an example would clear up confusion when potential contributors see node . <command> at line 59. However, we agree with you that having the exec command there is the better alternative.

Please let us know if there's anything else that we should change.

[wraithgar]

What's the thinking behind forcing yes to be false?

[rahulio96]

Forcing yes to be false is not really necessary, as this is just an example command. We included it because it was a reference to the last issue we worked on.

Would you prefer if we made the command broader and changed it to: npm exec -- <package> and node . exec -- <package> ?

[wraithgar]

Yeah suggestions, especially in readmes etc, should be as minimally prescriptive as possible. Folks are going to be copying and pasting it, and anything we bake in that they may not need by default is potentially confusing to them. Especially in this case the suggestion would fail for most folks who don't already have esbuild in their npx cache.

[wraithgar]

So yes, let's make it broader, exactly like your updated suggestions.

[rahulio96]

Just pushed those changes. Appreciate the explanation, that makes a lot of sense!

[wraithgar]

I think this line can be removed too. The advice is good for general testing if anything you're doing locally when developing, even long before you get to tests. Everything else looks good!

[rahulio96]

Okay, just removed that section, thanks for all your help!

[wraithgar]

Thank you