Skip to content

docs: add uniform install section to readmes #4633

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

wooorm-arcjet
Copy link
Member

@wooorm-arcjet wooorm-arcjet commented Jul 15, 2025

This PR adds a uniform install section to everything.

One open question is what to recommend with Deno.

Some changes with reasons:

  • Install instead of Installation — I just don’t see the need for the extra characters
  • sh instead of shell — same, people often use shorter flags here rather than entire language names (they are interchangeable on GH and in all tools that I am aware of)
  • no -S flag, which is the current behavior, and for people that choose to install with particular flags, this allows that.
  • mention npm and specifically also Node.js and here
  • explain that things are ESM only

Related-to: GH-4338.

@wooorm-arcjet wooorm-arcjet requested a review from a team as a code owner July 15, 2025 15:20
Copy link

trunk-io bot commented Jul 15, 2025

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

@davidmytton davidmytton requested a review from a team July 16, 2025 08:19
Install with XXX:

```sh
TODO: what should we recommend?
Copy link
Member

Choose a reason for hiding this comment

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

I would expect this to be


deno install npm:@arcjet/deno

Unless we are publishing to jsr? I have not had a chance to try deno yet, I can test it if you'd like

Copy link
Member Author

Choose a reason for hiding this comment

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

I did that, that’s probably good!

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