Skip to content

docs: update CONTRIBUTING.md with prerequisites and dependencies table#775

Merged
PaulHax merged 2 commits intoKitware:mainfrom
andinet:docs/update-contributing
Aug 20, 2025
Merged

docs: update CONTRIBUTING.md with prerequisites and dependencies table#775
PaulHax merged 2 commits intoKitware:mainfrom
andinet:docs/update-contributing

Conversation

@andinet
Copy link
Copy Markdown

@andinet andinet commented Aug 18, 2025

Summary

This PR updates CONTRIBUTING.md to include environment prerequisites and a dependencies table.
It helps contributors set up their environment correctly and avoid issues related to Node/npm/Vite compatibility.

Changes

  • Added Node.js (>= 18.20.0, 20.x LTS recommended) and npm (>= 9.x) requirements
  • Documented key dependencies from package.json (Vite, Vue, TypeScript, Vuetify, Pinia, vtk.js, itk-wasm, etc.)
  • Added guidance for checking versions and regenerating package-lock.json if schema errors occur
  • Kept existing setup, build, lint, test, and VTK.js development instructions intact

Issue

Closes #189

@netlify
Copy link
Copy Markdown

netlify Bot commented Aug 18, 2025

Deploy Preview for volview-dev ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 1cc9236
🔍 Latest deploy log https://app.netlify.com/projects/volview-dev/deploys/68a5c3cb7bdde70008791ee9
😎 Deploy Preview https://deploy-preview-775--volview-dev.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.

@andinet andinet requested review from PaulHax, floryst and jadh4v August 18, 2025 19:27
Comment thread CONTRIBUTING.md Outdated
Comment on lines +38 to +50
| Package | Version |
|------------------------|-------------|
| Vite | ^4.5.2 |
| Vue | ^3.5.13 |
| TypeScript | ~5.1.3 |
| Vitest | ^0.32.1 |
| Vuetify | 3.7.0 |
| Pinia | ^2.0.34 |
| @kitware/vtk.js | ^32.12.1 |
| itk-wasm | 1.0.0-b.188 |
| @itk-wasm/dicom | 7.6.0 |
| @sentry/vue | ^7.54.0 |
| @vueuse/core | ^13.0.0 |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

This will be hard to maintain. Lets just let the package.json hold this

Comment thread CONTRIBUTING.md Outdated
Comment on lines 25 to 29
If you encounter errors about `package-lock.json` schema, regenerate it:

```bash
rm package-lock.json
npm install
Copy link
Copy Markdown
Collaborator

@PaulHax PaulHax Aug 19, 2025

Choose a reason for hiding this comment

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

Deleting package-lock.json could cause bugs. Better to delete the node_modules folder. Lets just drop this basic how to hax javascript projects knolage and stick to volviews specific stuff.

@andinet
Copy link
Copy Markdown
Author

andinet commented Aug 20, 2025

@PaulHax, thanks for your review comments. I have updated the branch based on your feedback. Please review and merge it.

@PaulHax PaulHax added this pull request to the merge queue Aug 20, 2025
Merged via the queue into Kitware:main with commit bebd402 Aug 20, 2025
7 of 9 checks passed
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.

Specify node version in ReadMe

2 participants