Thanks Maarten.
Nathalie, Can we create a global place (google docs, github, something else?) where we can put this and potential other proposals so we can refer to them with links?
Tomas
From: Maarten Koning maarten.koning@windriver.com Date: Saturday, May 15, 2021 at 1:04 PM To: OpenAMP TSC tsc@lists.openampproject.org Cc: Nathalie Chan King Choy nathalie@xilinx.com, Tomas Evensen tomase@xilinx.com Subject: Biased terms
CAUTION: This message has originated from an External Source. Please use proper judgment and caution when opening attachments, clicking links, or responding to this email.
Hi all,
Below is some WR material on terminology that I would like to put forth as draft terminology guidelines for consideration by the group.
Maarten
Guidance - use inclusive language in documentation to support a diverse audience and to avoid distracting terminology. - when a biased term in project is encountered, notify the TSC for remediation - if there is risk that the replacement term is unclear to the audience, you can mention the industry-standard term verbally (for now), but not in writing. E.g.: “Open box testing (also known white-box testing) is a method of software testing that tests internal structures or workings of an application, as opposed to its functionality.” - do not use the below biased terms in your documentation; use the provided replacement terms. Biased term Replacement term black-box testing closed box testing black hat illegal blacklist forbidden list cripple slow, break, limit, or alter the functionality dummy packet test packet dummy variable placeholder variable female adapter socket grandfather legacy grey-list inspect list male adapter plug man hours labor hours or work hours man-in-the-middle (MITM) person-in-the-middle (PITM) manpower labor or workforce master (outside of the master/slave context) main master/slave For high availability: active/standby For clocks: primary/secondary For virtualization: host/guest For services: server/client For notifications: publisher (or provider) / subscriber For other scenarios: initiator/responder middleman middle person owner main white-box testing open box testing white hat legal whitelist allow list
<snip>