Inclusive language

2021-12-03T15:01:12Z

Jan-Simon Möller:

=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:
{| class="wikitable" border="2"
!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=

{| class="wikitable" border="2"
!Repo
!Current name
!Suggest rename
!Recommended by
!Approved name
|-
|core
|blacklist.bbclass
|excludelist.bbclass
| Armin
|
|-
|}

=Variables=

{| class="wikitable" border="2"
!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
|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=
{| class="wikitable" border="2"
!Repo
!Current name
!Suggest rename
!Recommended by
!Approved name
|-
|Bitabke
|test_setscenewhitelist
|
|
|
|-
|}

=Notes=

Some upstream references:
[https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/Documentation/process/coding-style.rst?h=v5.13&id=a5f526ecb075a08c4a082355020166c7fe13ae27][ Linux kernel]

DevDay Prague 2017

2017-10-26T12:16:20Z

Jan-Simon Möller:

Page for DevDay Prague 2017

Starting at 9:00am, 26 October [https://www.yoctoproject.org/yocto-project-developer-day-europe-2017 More info and tentative schedule]

== Begining Class ==

* Class Slides

[https://goo.gl/urRA8B]Beginning Class Slides

* Sample Code

== Advanced Class ==

* Class Slides

[https://wiki.yoctoproject.org/wiki/File:Yocto_DevDay_Advanced_Class_Prague.pdf] Advanced Class Slides (PDF)
[https://wiki.yoctoproject.org/wiki/File:Yocto_DevDay_Advanced_Class_Prague.pptx] Advanced Class Slides (PowerPoint)

* Sample Code

[https://wiki.yoctoproject.org/wiki/File:Event_overlap_py.txt]Sample script 'event_overlap.py'

* Class image set up

[https://wiki.yoctoproject.org/wiki/File:Devdey_class_image_setup.sh.txt]Sample script to prepare up the class image

* Devtool transcript

[https://wiki.yoctoproject.org/wiki/File:devtool.txt] devtool.txt

* CROPS eSDK notes (for Mac OS X)

[https://wiki.yoctoproject.org/wiki/File:crops-extsdk-mac.txt] crops-extsdk-mac.txt

* eSDK sample code

[https://wiki.yoctoproject.org/wiki/File:hello.c] hello.c

* User Space notes (command cheatsheet)

[https://wiki.yoctoproject.org/wiki/File:Cheatsheet_userspace.txt] Cheatsheet_userspace.txt

* CROPS Toaster notes (for Mac OS X)

[https://wiki.yoctoproject.org/wiki/File:crops-toaster-mac.txt] crops-toaster-mac.txt

* CROPS poky container notes (for Mac OS X)

[https://wiki.yoctoproject.org/wiki/File:crops-poky-mac.txt] crops-poky-mac.txt

Yocto Project - User contributions [en]

Inclusive language

DevDay Prague 2017