Inclusive language

From Yocto Project
Revision as of 19:14, 15 December 2021 by SaulWold (talk | contribs)
Jump to navigationJump to search

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

Patch Files

Repo Current name Suggest rename Recommended by Approved name
oe 0001-lxdm.conf.in-blacklist-root-for-release-images.patch 0001-lxdm.conf.in-deny-root-for-release-images.patch Saul Wold
oe 022-RH-Remove-the-property-blacklist-exception-builtin.patch 022-RH-Remove-the-default-property-exception-builtin.patch Saul Wold
core 11_tcpd_blacklist.patch 11_tcpd_blocklist.patch Saul Wold
core mount.blacklist mount.blocklist Saul Wold
meta-integrity /files/ima_signing_blacklist /files/ima_signing_blocklist Saul Wold
efi-secure-boot Fix-the-wrong-dependency-for-blacklist.esl.patch Fix-the-wrong-dependency-esl-file.patch Saul Wold

Notes

Some upstream references: [1][ Linux kernel]