excreationist
Married mouth-breather
At Epic Games, we have a few simple coding standards and conventions. This document reflects the state of Epic Games' current coding standards. Following the coding standards is mandatory.
........
Inclusive Word Choice
Word choice applies when you:
- name classes
- functions
- data structures
- types
- variables
- files and folders
- plugins.
It applies when you write snippets of user-facing text for the UI, error messages, and notifications. It also applies when writing about code, such as in comments and changelist descriptions.
The following sections provide guidance and suggestions....
Racial, ethnic, and religious inclusiveness
Do not use metaphors or similes that reinforce stereotypes. Examples include contrast black and white or blacklist and whitelist.
Do not use words that refer to historical trauma or lived experience of discrimination. Examples include slave, master, and nuke.
Gender inclusiveness
Refer to hypothetical people as they, them, and their, even in the singular.
Refer to anything that is not a person as it and its. For example, a module, plugin, function, client, server, or any other software or hardware component.
Do not assign a gender to anything that doesn't have one.
Do not use collective nouns like guys that assume gender.
Avoid colloquial phrases that contain arbitrary genders, like "a poor man's X".
.....
Overloaded Words
Many terms that we use for their technical meanings also have other meanings outside of technology. Examples include abort, execute, or native. When you use words like these, always be precise and examine the context in which they appear.
Well I thought that was surprising.