Community: [Discussion] Remove language that might come across inconsiderate

[mariantalla]

Inspiration for this comes from other open-source projects: https://github.com/facebook/jest/commit/59f6e3fd3fe6b502100a9c91ea22e91fe554136b and https://github.com/pivotal/docs-concourse-pcf/pull/22.

A quick and very superficial search brings back a pretty big number of occurrences of just/simple/simply/of course etc. - however, other than that, I haven't thoroughly looked into how frequently they pop up, and I haven't done any work whatsoever to gauge what the impact might be at the moment.

For now, I'm curious to hear what feedback or other input folks have on this, and we can talk complexity and next steps if we think it makes sense in principle.

[mariantalla]

/sig contributor-experience
/sig docs
seem like the most appropriate ones 🤔

[parispittman]

+1, on board. very considerate discussion topic ;) thanks for bringing this up @mariantalla

[mariantalla]

I see what you did there 🙃

[dims]

LOL +1 :)

[mrbobbytables]

+1 As well. Outside of being potentially inconsiderate, omitting unnecessary adverbs improves readability and helps non-native english speakers.

/cc @zacharysarah @jimangel @Bradamant3
For comments from docs 👍

[zacharysarah]

+1

Can we get rid of master and slave while we’re at it?

[jimangel]

BIG +1! Thanks @mariantalla!

[parispittman]

I don't think you'll see many folks disagree on principle. What about putting a plan together for the /community repo as a small(er) playground to test? If you want to recruit some folks to help (with plan or execution), mail this issue link to the contribex mailing list.

[tmart333]

@mariantalla as a novice to github and a non-coder, I'd love to be involved in this. I subscribed to this issue... is there something else I should do to track this? :)

[mbbroberg]

Hey @mariantalla :wave:, ping me if I can help scope how to tackle this!

[cblecker]

• We can use hound to help us find occurrences of a word across all our repos: https://cs.k8s.io/?q=just&i=fosho&files=%5C.md
• We have both a contribex and a sig-docs style guide.. if we want to remove certain language, we should update these style guides and notify k-dev

[mbbroberg]

Jumping back in (thanks for the nudge @mariantalla!). Thinking process-wise, I could see this issue being reframed as a meta issue with the following checklist items:

• [ ] use hound to find instances of undesirable language
• [ ] categorize these instances to make a set of issues people can fix
• [ ] update sig-docs style guide to advise on language
• [ ] notify k-dev of these updates and invite to edit

I'll be hanging out in #sig-contribex on Slack if you want to through through it more in real-time. Alternatively, it might be helpful to spin up a #temp-inclusive-language as a temporary channel to work through the problem.

Throwing this out here to start and happy to see where we want to run with it 🏃🏃

[mbbroberg]

Looking through hound, I see a ton of _just_ instances alone. They are, thankfully, not in a ton of repositories, so that could be the most natural separation for issues. For instance "Remove instances of uninclusive language from $REPO" as a template and that outlines the style guide updates.

[fejta-bot]

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.

If this issue is safe to close now please do so with /close.

Send feedback to sig-testing, kubernetes/test-infra and/or fejta.
/lifecycle stale

[mrbobbytables]

/remove-lifecycle stale
Theres some traction here the efforts going into removing whitelist/blacklist.
refs:
https://github.com/kubernetes/website/pull/21591
https://github.com/kubernetes/kubernetes/issues/90277
https://github.com/kubernetes/kubernetes/pull/91927

[celestehorgan]

/wg naming

Duplicate/overlapping issue: https://github.com/kubernetes/website/issues/17070

[mrbobbytables]

@celestehorgan do you think we should close this issue and track in k/website or another issue?

[celestehorgan]

@mrbobbytables The correct escalation for this issue (at this point) is to take this to the WG Naming mailing list and propose, for each term to replace, a replacement (or to remove the language entirely, as it were).

I can take care of that and we can close this issue after?

/assign

[mrbobbytables]

That sgtm! Thanks for taking point :)

[justaugustus]

/unassign @celestehorgan
/assign @zacharysarah

[zacharysarah]

Duplicate of https://github.com/kubernetes/website/issues/17070; I recommend closing this issue.

/close

[k8s-ci-robot]

@zacharysarah: Closing this issue.

In response to this:

Duplicate of https://github.com/kubernetes/website/issues/17070; I recommend closing this issue.

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.