Skip to content

Conversation

@josh-fell
Copy link
Contributor

@josh-fell josh-fell commented Feb 15, 2023

Related: #15994 #23090

This PR addresses a few items related to inclusive language use and the CI check:

  • There are several occurrences of "dummy" throughout documentation; however the current CI check for preventing non-inclusive language doesn't inspect docs/ files. Ideally, the docs also include inclusive language.
  • Even when removing docs/ from the exclusion list, non-inclusive language was still escaping pygrep. Upon inspection, the (?x) inline modifier was missing from the regex (although intended in Use inclusive words in apache airflow project #23090). Adding this modifier revealed these "dummy" instances and others related non-inclusive occurrences which were previously uncaught.
  • The exclusion list seemed too broad in places. There are still instances in which directories are excluded as a whole, but the list now is more tailored to non-inclusive occurrences that are beyond the purview of Airflow, history, dev/test files, etc.

@boring-cyborg boring-cyborg bot added area:API Airflow's REST/HTTP API area:dev-tools area:helm-chart Airflow Helm Chart provider:cncf-kubernetes Kubernetes (k8s) provider related issues area:plugins area:providers kind:documentation provider:docker provider:google Google (including GCP) related issues labels Feb 15, 2023
@josh-fell josh-fell force-pushed the inclusive-language-check branch 4 times, most recently from 112984e to 3a9ec1d Compare February 15, 2023 14:46
@josh-fell josh-fell marked this pull request as ready for review February 15, 2023 14:46
@josh-fell josh-fell force-pushed the inclusive-language-check branch from 3a9ec1d to da85a59 Compare February 21, 2023 13:42
@josh-fell josh-fell requested a review from Taragolis February 21, 2023 13:44
@josh-fell josh-fell force-pushed the inclusive-language-check branch from da85a59 to 3a5a873 Compare February 21, 2023 16:48
Related: apache#15994 apache#23090

This PR addresses a few items related to inclusive language use and the CI check:

- There are several occurrences of "dummy" throughout documentation; however the current CI check for preventing non-inclusive language doesn't inspect `docs/` files. Ideally, the docs also include inclusive language.
- Even when removing `docs/` from the exclusion list, non-inclusive language was still escaping pygrep. Upon inspection, the `(?x)` inline modifier was missing from the regex (although intended in apache#23090). Adding this modifier revealed these "dummy" instances and others related non-inclusive occurrences which were previously uncaught.
- The exclusion list seemed too broad in places. There are still instances in which directories are excluded as a whole, but the list now is more tailored to non-inclusive occurrences that are beyond the purview of Airflow, history, dev/test files, etc.
@josh-fell josh-fell force-pushed the inclusive-language-check branch from 3a5a873 to 34a2caa Compare February 22, 2023 03:44
@josh-fell
Copy link
Contributor Author

josh-fell commented Feb 22, 2023

Force pushing to hopefully get passed the test_cli_internal_api_background test now that it's quarantined. Thanks @Taragolis!

Copy link
Member

@uranusjr uranusjr left a comment

Choose a reason for hiding this comment

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

I didn’t check the exclude list; otherwise looks good to me.

@josh-fell josh-fell merged commit dba390e into apache:main Feb 22, 2023
@josh-fell josh-fell deleted the inclusive-language-check branch February 22, 2023 14:45
@pierrejeambrun pierrejeambrun added this to the Airflow 2.5.2 milestone Feb 27, 2023
@pierrejeambrun pierrejeambrun added the changelog:skip Changes that should be skipped from the changelog (CI, tests, etc..) label Feb 27, 2023
@pierrejeambrun
Copy link
Member

Requires a bunch of CI/dev commits to avoid conflicts on .pre-commit-config.yaml moving to 2.6

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:API Airflow's REST/HTTP API area:dev-tools area:helm-chart Airflow Helm Chart area:plugins area:providers changelog:skip Changes that should be skipped from the changelog (CI, tests, etc..) kind:documentation provider:cncf-kubernetes Kubernetes (k8s) provider related issues provider:docker provider:google Google (including GCP) related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants