DOC/CLN: Fix errors in Series docstrings by dsaxton · Pull Request #24945 · pandas-dev/pandas (original) (raw)

This should be the output for the docstrings edited so far in this PR.

to_string

3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found
Docstring for "pandas.core.series.Series.to_string" correct. :)

to_dict

2 Warnings found:
    No extended summary found
    See Also section not found
Docstring for "pandas.core.series.Series.to_dict" correct. :)

to_frame

3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found
Docstring for "pandas.core.series.Series.to_frame" correct. :)

to_sparse

(I think the first error is wrong here because "integer" is actually a string in the docstring. For this one I'm not familiar enough with the method to add a good description. Also, I think this will be deprecated soon anyways?)

2 Errors found:
    Parameter "kind" type should use "int" instead of "integer"
    Parameter "kind" has no description
3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found

count

3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found
Docstring for "pandas.core.series.Series.count" correct. :)

mode

2 Warnings found:
    See Also section not found
    No examples section found
Docstring for "pandas.core.series.Series.mode" correct. :)

drop_duplicates

(This is another one where the lowercase letter is an argument option.)

1 Errors found:
    Parameter "keep" description should start with a capital letter
1 Warnings found:
    No extended summary found

duplicated

(Same here.)

1 Errors found:
    Parameter "keep" description should start with a capital letter

idxmin

2 Errors found:
    Parameters {*args, **kwargs} not documented
    Unknown parameters {*args, **kwargs}

idxmax

2 Errors found:
    Parameters {*args, **kwargs} not documented
    Unknown parameters {*args, **kwargs}

round

1 Errors found:
    Parameters {**kwargs, *args} not documented
2 Warnings found:
    No extended summary found
    No examples section found

quantile

6 Errors found:
    Parameter "q" description should start with a capital letter
    Parameter "q" description should finish with "."
    Parameter "interpolation" has no description
    Return value description should start with a capital letter
    Missing description for See Also "core.window.Rolling.quantile" reference
    Missing description for See Also "numpy.percentile" reference

corr

6 Errors found:
    Parameter "other" has no description
    Parameter "method" description should start with a capital letter
    Parameter "method" description should finish with "."
    Parameter "min_periods" description should finish with "."
    Return value has no description
    flake8 error: E124 closing bracket does not match visual indentation
2 Warnings found:
    No extended summary found
    See Also section not found

cov

4 Errors found:
    Parameter "other" has no description
    Parameter "min_periods" description should finish with "."
    Return value has no description
    Return value has no description
3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found

diff

Docstring for "pandas.core.series.Series.diff" correct. :)

append

6 Errors found:
    Parameter "to_append" has no description
    Parameter "ignore_index" type should use "bool" instead of "boolean"
    Parameter "verify_integrity" type should use "bool" instead of "boolean"
    Parameter "verify_integrity" description should finish with "."
    Return value has no description
    flake8 error: E231 missing whitespace after ',' (2 times)
1 Warnings found:
    No extended summary found

sort_index

Docstring for "pandas.core.series.Series.sort_index" correct. :)

argsort

4 Errors found:
    Summary must start with infinitive verb, not third person (e.g. use "Generate" instead of "Generates")
    Summary should fit in a single line
    Parameter "kind" description should finish with "."
    Missing description for See Also "numpy.ndarray.argsort" reference
1 Warnings found:
    No examples section found

swaplevel

4 Errors found:
    Parameters {j, copy, i} not documented
    Unknown parameters {i, j}
    Parameter "i, j" type should use "str" instead of "string"
    Return value has no description
3 Warnings found:
    No extended summary found
    See Also section not found
    No examples section found

unstack

7 Errors found:
    Summary should fit in a single line
    Parameter "level" type should use "str" instead of "string"
    Parameter "level" description should finish with "."
    Parameter "fill_value" description should start with a capital letter
    Parameter "fill_value" description should finish with "."
    Return value has no description
    flake8 error: E128 continuation line under-indented for visual indent
1 Warnings found:
    See Also section not found

rename

7 Errors found:
    Parameters {**kwargs} not documented
    Unknown parameters {level, inplace, copy}
    Parameter "index" description should start with a capital letter
    Parameter "copy" description should finish with "."
    Return value has no description
    Missing description for See Also "Series.rename_axis" reference
    flake8 error: E261 at least two spaces before inline comment

drop

4 Errors found:
    Parameters {columns, index} not documented
    Unknown parameters {index, columns}
    Return value has no description
    flake8 error: E231 missing whitespace after ',' (3 times)

isin

Docstring for "pandas.core.series.Series.isin" correct. :)

between

Docstring for "pandas.core.series.Series.between" correct. :)

from_csv

3 Errors found:
    Parameter "path" has no description
    Return value has no description
    Missing description for See Also "read_csv" reference
1 Warnings found:
    No examples section found

valid

2 Errors found:
    Parameters {inplace, **kwargs} not documented
    No Returns section found
2 Warnings found:
    See Also section not found
    No examples section found

to_period

2 Errors found:
    Summary should fit in a single line
    Parameters {copy} not documented
2 Warnings found:
    See Also section not found
    No examples section found