Skip to content

DOC: Fixed outdated doc-string, added missing default values, added missing optional parameters for some io classes #11098

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

Merged
merged 1 commit into from
Sep 17, 2015

Conversation

terrytangyuan
Copy link
Contributor

Some doc-strings are outdated, in a sense that there are missing newly added optional parameters and default values.

@jorisvandenbossche
Copy link
Member

@terrytangyuan The changes look good, but, the data.py is now maintained at https://github.com/pydata/pandas-datareader. So maybe you can do a PR for that file there

right boundary for range (defaults to today)
retry_count : int, default 3
Number of times to retry query request.
pause : int, default 0.001
Copy link
Member

Choose a reason for hiding this comment

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

this should be float I assume? (or 'numeric')

@terrytangyuan
Copy link
Contributor Author

@jorisvandenbossche Nice catch! Thanks for checking. I've made the changes. I'll submit another PR to make changes on the new file.

@terrytangyuan
Copy link
Contributor Author

@jorisvandenbossche On green now. Can you merge?

@@ -400,26 +405,26 @@ def get_data_yahoo(symbols=None, start=None, end=None, retry_count=3,
----------
symbols : string, array-like object (list, tuple, Series), or DataFrame
Single stock symbol (ticker), array-like object of symbols or
DataFrame with index containing stock symbols.
DataFrame with index containing stock symbols, default: None
Copy link
Contributor

Choose a reason for hiding this comment

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

Should be two lines above?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@kawochen Do you mean the default: None?

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes. On line 406 instead (not sure but it looks like that's how other function parameters are documented)?

…issing optional parameters for some io classes (+1 squashed commit)

Squashed commits:
[7851d88] DOC: Fixed outdated doc-string, added missing default values, added missing optional parameters for some io classes (+1 squashed commit)
Squashed commits:
[1a77b43] DOC: Fixed outdated doc-string, added missing default values, added missing optional parameters for some io classes (+1 squashed commit)
Squashed commits:
[739945e] DOC: Fixed outdated doc-string, added missing default values, added missing optional parameters for some io classes
@terrytangyuan
Copy link
Contributor Author

Thanks @kawochen Fixed and on green now.

@jreback
Copy link
Contributor

jreback commented Sep 17, 2015

I guess this is fine. @terrytangyuan prob strip off the stuff for pandas-datareader and submit there as well.

@jreback jreback added this to the 0.17.0 milestone Sep 17, 2015
jreback added a commit that referenced this pull request Sep 17, 2015
DOC: Fixed outdated doc-string, added missing default values, added missing optional parameters for some io classes
@jreback jreback merged commit d28fd70 into pandas-dev:master Sep 17, 2015
@terrytangyuan terrytangyuan deleted the docs branch September 17, 2015 17:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants