Inclusive language

Inclusive Language

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.

For reference: https://inclusivenaming.org/word-lists/overview/

Game play

If a BB variable has a local assignment, the rename should be transitive. Example: BB_HASHBASE_WHITELIST is changed 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	whitelist
denylist	allowlist
blocklist	passlist
excludes or excludelist	includes or 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_ENV_EXTRAWHITE	BB_ENV_EXTRA_ALLOWLIST	Saul Wold
Bitbake	BB_HASHCONFIG_WHITELIST
Bitbake	BB_STAMP_WHITELIST
Bitbake	BB_SETSCENE_ENFORCE_WHITELIST
Bitbake	BB_HASHBASE_WHITELIST
Bitbake	MULTI_PROVIDER_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
core	ICECC_USER_CLASS_BL	ICECC_USER_CLASS_EXCLUDES	Michael Opdenacker
core	ICECC_USER_PACKAGE_BL	ICECC_USER_PACKAGE_EXCLUDES	Michael Opdenacker
core	CVE_CHECK_WHITELIST	CVE_CHECK_IGNORELIST	Yuichi Ito
core	SYSROOT_DIRS_BLACKLIST
core	INHERIT_BLACKLIST
core	SDK_LOCAL_CONF_BLACKLIST
core	SDK_LOCAL_CONF_WHITELIST
core	SDK_INHERIT_BLACKLIST
core	WHITELIST_GPL-3.0
core	TUNEABI_WHITELIST
core	LICENSE_FLAGS_WHITELIST
core	UNKNOWN_CONFIGURE_WHITELIST

Functions

Repo	Current name	Suggest rename	Recommended by	Approved name
Bitabke	test_setscenewhitelist

Notes

Some upstream references: [1][ Linux kernel]