Skip to content

Added a check for standard documentation #33592

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

Closed
wants to merge 7 commits into from
Closed

Added a check for standard documentation #33592

wants to merge 7 commits into from

Conversation

willie3838
Copy link
Contributor

I created a check to see which files contain Pandas or pandas which will be of use for individuals aiming to resolve issue #32316. When the codecheck script is run, it will output the files that contain those strings.

@jbrockmendel
Copy link
Member

The CI is failing because of trailing whitespace in the code check file

fi
done

exit $RET
Copy link
Contributor

Choose a reason for hiding this comment

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

think you need a newline here

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sorry I'm not too sure what you mean, I'm new to this. Do you want me to add a new line after done?

Copy link
Member

Choose a reason for hiding this comment

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

Do you want me to add a new line after done?

yes please

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I have added a new line after done as requested!

Copy link
Member

Choose a reason for hiding this comment

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

@willie3838 think you added the new line in the wrong spot. Should come at the end of this line not preceding

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@willie3838 think you added the new line in the wrong spot. Should come at the end of this line not preceding

I have added your solution, let me know if it still does not resolve the issue.

Copy link
Member

Choose a reason for hiding this comment

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

There needs to be a newline at the end of this file

@@ -378,4 +378,13 @@ if [[ -z "$CHECK" || "$CHECK" == "typing" ]]; then
fi


### Checking for standardized documentation ###
echo "Checking which files in pandas/doc/source have standardized documentation"
Copy link
Member

Choose a reason for hiding this comment

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

I think this check should go under the ### PATTERNS ### further up this file.

Could you also follow the pattern those checks have?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed!

@@ -237,6 +237,14 @@ if [[ -z "$CHECK" || "$CHECK" == "patterns" ]]; then
invgrep -RI --exclude=\*.{svg,c,cpp,html,js} --exclude-dir=env "\s$" *
RET=$(($RET + $?)) ; echo $MSG "DONE"
unset INVGREP_APPEND

MSG = 'Check files that in pandas/doc/source that use standardized documentation' ; echo $MSG
for entry in $(find ../doc/source/ -type f)
Copy link
Member

@mroeschke mroeschke Apr 23, 2020

Choose a reason for hiding this comment

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

I think instead of the for we can use the invgrep pattern like the check above this.

@jbrockmendel jbrockmendel added Docs Code Style Code style, linting, code_checks labels Apr 23, 2020
@simonjayhawkins
Copy link
Member

@willie3838 can you address comments #33592 (comment) and #33592 (comment)

@jreback
Copy link
Contributor

jreback commented Jun 20, 2020

@willie3838 can you merge master and address comments

@jreback
Copy link
Contributor

jreback commented Jul 17, 2020

closing as stale
pls ping if u want to continue

@jreback jreback added this to the No action milestone Jul 17, 2020
@jreback jreback closed this Jul 17, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Code Style Code style, linting, code_checks Docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants