Skip to content

docs: add docstring guidelines to CONTRIBUTING.md#1957

Merged
MarcoGorelli merged 2 commits intomainfrom
docs/add-docstring-guidelines-to-contributing
Feb 8, 2025
Merged

docs: add docstring guidelines to CONTRIBUTING.md#1957
MarcoGorelli merged 2 commits intomainfrom
docs/add-docstring-guidelines-to-contributing

Conversation

@FBruzzesi
Copy link
Member

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

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

Related issues

Checklist

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

If you have comments or can explain your changes, please do so below

All other changes are unrelated via markdownlint

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 @FBruzzesi

CONTRIBUTING.md Outdated
Writing the docstring in Narwhals is not an exact science, but we have some high level guidelines (if in doubt just ask us in the PR):

- The examples should be clear and to the point.
- The examples should import _one_ dataframe library, create a datafrane and exemplify the Narwhals functionality.
Copy link
Member

Choose a reason for hiding this comment

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

dataframe typo

@MarcoGorelli MarcoGorelli added the documentation Improvements or additions to documentation label Feb 8, 2025
@MarcoGorelli MarcoGorelli merged commit a47a255 into main Feb 8, 2025
22 of 24 checks passed
@MarcoGorelli MarcoGorelli deleted the docs/add-docstring-guidelines-to-contributing branch February 8, 2025 14:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docstring guidelines

2 participants