Inclusive language

From Yocto Project
Revision as of 12:04, 7 July 2021 by Armin Kuster (talk | contribs)
Jump to navigationJump to search

Inclusive Lanquage

First time topic was explored on mailing list. https://lists.openembedded.org/g/openembedded-architecture/topic/inclusive_language_summary/75821819

This is an attempt to collate Inclusive Language for OpenEmbedded and the Yocto Project in regards to code.

= Game play If a BB variable has a local assignment, the rename should be transitive. Example: BB_HASHBASE_WHITELIST is changes to BB_HASHBASE_ALLOWLIST, then self.basewhitelist would become self.baseallowlist

Add an offending name in one of the three tables below. If you have a suggested replacement, please add. If the translation is approved, that will be noted in the same row. Approval process: TBD


Recommendations

Recommended replacements for 'blacklist/whitelist' are:

blacklist whiltelist
denylist allowlist
blocklist passlist
excludelist includelist

Exceptions

Exceptions for introducing new usage is limited upstream sources outside the control of The Yocto Project and OpenEmbedded.

Classes

Repo Current name Suggest rename Recommended by Approved name
core blacklist.bbclass excludelist.bbclass Armin

Variables

Repo Current name Suggest rename Recommended by Approved name
Bitbake BB_ENV_WHITELIST BB_ENV_ALLOWLIST Armin Kuster
Bitbake BB_HASHCONFIG_WHITELIST
Bitbake BB_STAMP_WHITELIST
Bitbake BB_SETSCENE_ENFORCE_WHITELIST
Bitbake BB_HASHBASE_WHITELIST
Bitbake basewhitelist
Bitbake taskwhitelist
core PNBLACKLIST PNSKIPLIST Armin
core whitelist excludelist Armin
core whitelisted excluded Armin
core whitelisting excluding Armin
core SSTATE_DUPWHITELIST SSTATE_DUPSKIPLIST Armin
core CVE_CHECK_PN_WHITELIST CVE_CHECK_PN_SKIPIST Armin

Functions

Repo Current name Suggest rename Recommended by Approved name
Bitabke test_setscenewhitelist

Notes

Some upstream references: [1][ Linux kernel]