Skip to content

Conversation

@fa9r
Copy link
Contributor

@fa9r fa9r commented Aug 26, 2022

Describe changes

I made two changes to our GitHub Actions:

  • Docstring checking was removed from linting is now in a separate job that is only run on once machine.
  • Markdown checking now runs in quiet mode (only prints links that are broken) and its job can no longer fail so it does not affect the overall CI result

Pre-requisites

Please ensure you have done the following:

  • I have read the CONTRIBUTING.md document.
  • If my change requires a change to docs, I have updated the documentation accordingly.
  • If I have added an integration, I have updated the integrations table and the corresponding website section.
  • I have added tests to cover my changes.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Other (add details above)

@fa9r fa9r requested review from schustmi and strickvl August 26, 2022 14:20
@github-actions github-actions bot added the internal To filter out internal PRs and issues label Aug 26, 2022
Copy link
Contributor

@strickvl strickvl left a comment

Choose a reason for hiding this comment

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

Let's go to main!

@fa9r fa9r force-pushed the misc/separate-docstring-ci-checks-from-lint branch from 973eca6 to 360ee2e Compare August 26, 2022 15:07
CONTRIBUTING.md Outdated
Comment on lines 142 to 145
poetry run bash scripts/format.sh
poetry run bash scripts/lint.sh
poetry run bash scripts/docstring.sh
poetry run bash scripts/check-spelling.sh
Copy link
Contributor

Choose a reason for hiding this comment

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

wonder whether this a lot for people to do & if we should consider consolidating some of these into a single command for the sake of external contributors, albeit keeping the individual scripts / commands for ourselves...)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Great idea! I added a run-ci-checks.sh script that combines linting, docstring checks, and spell checks and adjusted the contributing guide accordingly.

@fa9r fa9r merged commit 9a5c7aa into develop Aug 29, 2022
@fa9r fa9r deleted the misc/separate-docstring-ci-checks-from-lint branch August 29, 2022 10:40
@fa9r fa9r changed the title Split docstring check into a separate action that only runs once Update GitHub Actions Aug 29, 2022
stefannica pushed a commit that referenced this pull request Sep 14, 2022
* Split docstring checking into a separate GitHub action that only runs once.

* Adjust precommit and contributer guide.

* Always pass markdown link checker and make output more concise.

* Add script for external contributors that runs linting, spell checking, and docstring checking.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal To filter out internal PRs and issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants