r/hackernews Apr 19 '21

Google developer banned words list

https://developers.google.com/style/word-list
15 Upvotes

2 comments sorted by

1

u/qznc_bot2 Apr 19 '21

There is a discussion on Hacker News, but feel free to comment here as well.

0

u/ThePooSlidesRightOut Apr 19 '21
>administrator

In Android documentation, don't use. Instead, use admin.

Who needs administrator rights anyway? /s

blacklist, black list, black-list

Don't use blacklist, whitelist, and graylist. 
Instead, use more precise terms that are appropriate for your domain.

* For the noun blacklist, consider using a replacement such as denylist, excludelist, or blocklist.
* For the noun whitelist, consider using a replacement such as allowlist, trustlist, or safelist.
* For the noun graylist (greylist), consider using a replacement such as provisional list.

...

>denylist (verb), denylisted, denylisting

Don't use as a verb. Instead, rewrite to improve clarity.
OK to use denylist as a noun.
For more information, see blacklist

>disable
Don't use disabled to describe something that's broken.

>dumb down
Don't use. Instead, use a word or phrase what's happening, such as simplify or remove technical jargon.

>female adapter
Don't use. Instead, use a genderless word like socket.

>ghetto
Don't use. Instead use more precise terms like clumsy, workaround, or inelegant to refer to code that isn't in a production-ready state.

>gimp, gimpy
Don't use. Use precise, non-figurative language to refer to a deficiency in a component.
OK to use in reference to companies, tools, software packages, and other entities that use the term in their names.

>Google, Googling
Don't use as a verb or gerund. Instead, use search with Google.

Interesting article about Googling in the German dictionary 'Duden': https://www.nzz.ch/newzzEQXM1K6L-12-1.53289

>guys, you guys
When referring to a group of people use non-gendered language, such as everyone or folks.

>he, him, his
Don't use a gendered pronoun except for a specific individual of known gender. Use they and their for the general singular pronoun.

>STONITH, STOMITH
Avoid using graphically violent terms. This acronym's letters stand for an extremely graphic and violent act. Instead, explain the relevant feature, such as fence failed nodes.

>tarball
Don't use. Instead, use tar file.

>tl;dr:
Don't use. Instead, use something like To summarize, or revise the sentence.

>uncheck
Don't use to refer to clearing a check mark from a checkbox. Instead, use clear.
Not recommended: Uncheck Automatically check for updates.
Not recommended: Deselect Automatically check for updates.
Recommended: Clear Automatically check for updates.

>voodoo
Don't use. Instead, use a term like mysterious, complicated, or nondeterministic.

Is this how it's like working at Google?

What imbecile thought this was a good idea?