Module:Inclusive language

From mediawiki.org
Module documentation

Usage[edit]

{| class="wikitable"
! Words to be avoided !! Suggested alternative words !! Context
|-
{{#invoke:Inclusive language|main}}
|}

By default, it uses the list at Inclusive language/words.

Words to be avoided Suggested alternative words Context
blacklist denylist, deny, exclude, prohibit, forbid, mute, (But not "block" or "ban" because of existing MediaWiki meanings) Avoid language that perpetuates discrimination
whitelist allowlist, allow, include, permit Avoid language that perpetuates discrimination
master primary, source, main, development branch Avoid language that perpetuates discrimination
slave replica, secondary Avoid language that perpetuates discrimination
guys people, folks Avoid unnecessarily gendered language
Words that assume someone's gender, including "sir"/"madam" Gender-neutral terms or the person's name; or check their userpage, Phab profile, etc., to see if they've shared how they identify Avoid misgendering
sanity check is valid, is correct, integrity check, final check, quick check, completeness check, confidence check, coherence check, double check Avoid ableist language
sane reasonable, typical, common Avoid ableist language
crazy, insane wild, confusing, confounding Avoid ableist language
blindly, dumb mindlessly, without validating Avoid ableist language
crippled slowed, broken Avoid ableist language
kill switch, kill it with fire off switch, emergency switch, feature flag, remove Avoid unnecessarily violent language
grandfathered legacy, exempt Avoid language that perpetuates discrimination
handicap hurt, negatively affect Avoid ableist language
(In some contexts) disable/disabled Guides vary, with some stating that it is acceptable to use it (perhaps just in technical documentation), and others recommending replacement with 'deactivate, inactive, unavailable, turn off, deselect'.[1][2][3] Avoid ableist language
abort cancel, force quit, end, halt, stop, hard stop Politically charged term outside of computing. Avoid unnecessarily violent language.
blackhat, whitehat unethical hacker, attacker, ethical hacker Avoid language that perpetuates discrimination
tribe team, squad, group Can be assocaited with colonialism / cultural approriation. Avoid language that perpetuates discrimination.


local p = {}

function p.main( frame )
    local words = mw.title.makeTitle( '', 'Inclusive language/words' )
    
    local decoded = mw.text.jsonDecode( words:getContent() )
    local output = {}
    
    for i, v in ipairs(decoded) do
    	table.insert(output, "| " .. table.concat(v.avoid, ", ") .. " || " .. table.concat(v.use, ", ") .. " || " .. v.context)
    	table.insert(output, "|-")
    end
    
    return table.concat(output, "\n")
end

return p