Skip to content
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

docs(python): Fix various typos, grammar and formatting in docstrings and user guide #13506

Merged
merged 3 commits into from
Jan 7, 2024

Conversation

henryharbeck
Copy link
Contributor

Changes include

  • Typos, grammar, punctuation, formatting
  • Erroneous "underlying data, the names given here will overwrite them." line was repeated in docstrings
  • Fix some "smallest" / "largest" references in top_k / bottom_k
  • References to a LazyFrame being a DataFrame and vice-versa

I did notice a few more references to a LazyFrame being a DataFrame and vice-versa (for example in LazyFrame.join), but will leave for another PR to keep the size manageable.

@github-actions github-actions bot added documentation Improvements or additions to documentation python Related to Python Polars labels Jan 7, 2024
@@ -140,7 +140,7 @@ class LazyFrame:
Two-dimensional data in various forms; dict input must contain Sequences,
Generators, or a `range`. Sequence may contain Series or other Sequences.
schema : Sequence of str, (str,DataType) pairs, or a {str:DataType,} dict
The DataFrame schema may be declared in several ways:
The LazyFrame schema may be declared in several ways:
Copy link
Contributor Author

@henryharbeck henryharbeck Jan 7, 2024

Choose a reason for hiding this comment

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

Techincally, you are declaring a DataFrame schema when initialising a LazyFrame through this class, however I think this update reduces potential confusion to the reader.

@alexander-beedie
Copy link
Collaborator

This is a great collection of fixes - well spotted!✌️

@henryharbeck henryharbeck changed the title docs(python): Fix various typos, grammar and formatting in docstings and user guide docs(python): Fix various typos, grammar and formatting in docstrings and user guide Jan 7, 2024
Copy link
Contributor

@stinodego stinodego left a comment

Choose a reason for hiding this comment

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

Great, thanks!

@stinodego stinodego merged commit 1f8ec98 into pola-rs:main Jan 7, 2024
18 checks passed
@henryharbeck henryharbeck deleted the typos branch January 9, 2024 10:53
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 python Related to Python Polars
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants