martinsson / BugsZero-Kata

Practice Designing code for less bugs
86 stars 131 forks source link

Inclusive language in readme #3

Closed dertseha closed 6 years ago

dertseha commented 6 years ago

In the spirit of the advanced instructions, I'll describe an issue in the current form of the README.md.

  1. Weakness: Text does not have an inclusive language. Specifically in the subsentence ...it is likely that a developer would create a bug if he extended the code.
  2. What is the potential bug: Using "male-centric" wording supports the stereotype of developers being male. Yet developers come in all shapes and forms, including genders. The text is not about a particular example person, it is meaning "any" person.
  3. Proposed alternatives: Here it can become tricky, yet the English language gives us options. Suggestions:

How do you see it?

martinsson commented 6 years ago

Thanks for noting! I like the first and the third alternatives. Feel free to PR, otherwise I hope I'll get to it Friday

martinsson commented 6 years ago

Awesome to use the spirit :)

dertseha commented 6 years ago

Pull request created.

I've opted for the complete-plural version (first one), since the third one, in the complete sentence, could have been interpreted as "You'll practice ... by extending the code.". i.e., the person that wants to practice would be practicing by extending the code. And the most likely necessary comma would be too small to make the difference. Now it's "one person practicing" and "many people making bugs when extending code".

Thank you for the opportunity to contribute!