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: correct definitions, broken link and grammar, capitalization, punctuation in python client documentation #2940

Merged
merged 16 commits into from
Jun 18, 2024

Conversation

raphaelbalzer
Copy link
Contributor

@raphaelbalzer raphaelbalzer commented Jun 17, 2024

Purpose

This PR aims to improve the documentation for the python client by fixing minor typos, grammar mistakes as well as inaccurate parameter definitions.

Most important changes

  • Corrected the definitions of the start_date and end_date parameters of the get() method for measurements.
  • Rephrased some sentences in the tutorials to be more comprehensive.

Remarks

PR introduces (a) breaking change(s): no

PR introduces (a) deprecation(s): no

…easure.py

The definitions of start- and end_date are reversed:

end_date: This option restricts the queried data to be younger than the specified time. This means that only data after the specified timestamp will be retrieved. For example, if end_date is set to January 1, 2023, only data from January 2, 2023, or later would be retrieved, going forward in time.

start_date: This option restricts the queried data to be older than the specified time. This means that only data before the specified timestamp will be retrieved. If start_date is set to January 1, 2023, only data before January 1, 2023, would be retrieved, i.e., December 31st, 2022, and earlier, going back in time.

These definitions imply that the end date lies further in the past than the start_date. This is in fact wrong because it should be the other way around. Accordingly, the definitions have been corrected.
@github-actions github-actions bot added python Pull requests that update Python code documentation Everything related to documentation labels Jun 17, 2024
Copy link
Contributor

@bossenti bossenti left a comment

Choose a reason for hiding this comment

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

Thanks for cleaning up @raphaelbalzer 🙏🏼

@bossenti bossenti merged commit 28ea9a1 into apache:dev Jun 18, 2024
21 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Everything related to documentation python Pull requests that update Python code
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants