Skip to content

docs: update stale version requirements and replace Yarn with npm#5600

Open
ms2073 wants to merge 1 commit intoup-for-grabs:gh-pagesfrom
ms2073:fix/docs-stale-versions-and-yarn-20260308
Open

docs: update stale version requirements and replace Yarn with npm#5600
ms2073 wants to merge 1 commit intoup-for-grabs:gh-pagesfrom
ms2073:fix/docs-stale-versions-and-yarn-20260308

Conversation

@ms2073
Copy link

@ms2073 ms2073 commented Mar 7, 2026

Problem

The contributor documentation had significantly outdated information that would cause setup failures for new contributors:

  1. Wrong version requirementsCONTRIBUTING.md states Ruby 3 / Node 16+, but the repo's Gemfile requires ruby '~> 4.0', .ruby-version is 4.0.0, and package.json engines specify node >=24, npm >=11
  2. Wrong toolchaindocs/setup.md uses Yarn throughout, but the project has no yarn.lock, package.json specifies npm >=11, and all CI scripts use npm
  3. Non-existent scriptyarn prettify does not exist; the correct command is npm run prettier
  4. Wrong config file — references eslintrc.json but the project migrated to ESLint flat config (eslint.config.mjs)
  5. Outdated Docker links — all three Docker install links redirected to new URLs

Changes

.github/CONTRIBUTING.md

  • Ruby 3 → Ruby 4, Node 16+ → Node 24+, Bundler 2.2 → 2.x
  • Update example version output to match current toolchain
  • Fix Docker install links for Windows, macOS, and Linux

docs/setup.md

  • Replace yarnnpm install
  • Replace yarn prettifynpm run prettier
  • Replace yarn lintnpm run lint
  • Fix eslintrc.jsoneslint.config.mjs

docs/client-side-scripting.md

  • Replace yarn testnpm test

Verification

  • Verified actual requirements against Gemfile, .ruby-version, package.json
  • Confirmed npm run prettier, npm run lint, npm test exist in package.json
  • Confirmed eslint.config.mjs exists in repo root
  • All new Docker links verified returning HTTP 200

CONTRIBUTING.md:
- Update Ruby requirement from 3 to 4 (repo uses ruby '~> 4.0')
- Update Node requirement from 16+ to 24+ (package.json engines: node >=24)
- Update example output to reflect current Ruby 4.0 and Node 24.x
- Fix outdated Docker install links for Windows, macOS, and Linux

docs/setup.md:
- Replace Yarn with npm throughout (no yarn.lock exists, package.json
  specifies npm >=11 engine)
- Fix 'yarn prettify' (script does not exist) → 'npm run prettier'
- Fix 'yarn lint' → 'npm run lint'
- Fix eslintrc.json reference → eslint.config.mjs (flat config)

docs/client-side-scripting.md:
- Fix 'yarn test' → 'npm test'
@netlify
Copy link

netlify bot commented Mar 7, 2026

Deploy Preview for up-for-grabs-test-bench ready!

Name Link
🔨 Latest commit cffb3e6
🔍 Latest deploy log https://app.netlify.com/projects/up-for-grabs-test-bench/deploys/69acb79d389cad0008db0d79
😎 Deploy Preview https://deploy-preview-5600--up-for-grabs-test-bench.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@shiftbot
Copy link
Contributor

shiftbot commented Mar 7, 2026

👋 I'm a robot checking the state of this pull request to save the human reviewers time. I don't see any changes under _data/projects/ so I don't have any feedback here.

As you make changes to this pull request, I'll re-run these checks.

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