Skip to content

Conversation

@ym-pett
Copy link
Contributor

@ym-pett ym-pett commented Dec 9, 2025

Description

I had difficulties following local reinstallation of Narwhals. I wonder if it would be worth adding to the Contributing file for less experienced users? I've tried to keep it as minimal as possible as I didn't want to break the flow.

First I tried having it as a bullet point of the tldr installation, but that didn't seem right, as it's not a necessary first step. I've left it at 'may need to' to hedge for the fact that this might get fixed sometime in the future and we might forget to fix the contributing, but happy to change.

What type of PR is this? (check all applicable)

  • 💾 Refactor
  • ✨ Feature
  • 🐛 Bug Fix
  • 🔧 Optimization
  • 📝 Documentation
  • ✅ Test
  • 🐳 Other

Related issues

  • Related issue #<issue number>
  • Closes #<issue number>

Checklist

  • Code follows style guide (ruff)
  • Tests added
  • Documented the changes

@ym-pett
Copy link
Contributor Author

ym-pett commented Dec 9, 2025

ugh failing tests - do I need to do anything about these? Didn't have local failures.

Copy link
Member

@MarcoGorelli MarcoGorelli left a comment

Choose a reason for hiding this comment

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

thanks @ym-pett , good to have this

should this also be added to the detailed steps further down?

@ym-pett
Copy link
Contributor Author

ym-pett commented Dec 9, 2025

yes I think you're right, will try to add something without breaking the clarity.

CONTRIBUTING.md Outdated
Static typing is run separately from `pre-commit`, as it's quite slow. Assuming you followed all the instructions above, you can run it with `make typing`.
Finally, if you've had to update the install of Narwhals after changes, it can happen that a part of the testing functionality is no longer available, and you will see `pytest` errors around the `test_plugin`. This can be fixed by separately re-installing by running `uv pip install -e ./test-plugin`.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

what do you think of this? Is it too wordy?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ps: annoyingly, the 'conversation' view shows the old version of the edits but the file view has the latest version.

@MarcoGorelli
Copy link
Member

thanks @ym-pett ! i found that we can simply combine the install steps so i've done that

@MarcoGorelli MarcoGorelli merged commit 56a7da9 into narwhals-dev:main Dec 12, 2025
33 of 34 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.

2 participants