Improve the inclusivity of the language in Access_Control_Cheat_Sheet.md #402
Conversation
|
Hi @ben-dale, Thanks for submitting these. Most of these changes are good, but I've made a few comments on a few specific ones. In some cases you're suggesting changes to words that aren't quite synonymous (for example "clearly" and "precisely"), which in some cases is changing the emphasis of what's being said. Many of the readers of these cheat sheets don't have English as their first language, so where we can we try and keep the language simpler (as much as you can in technical documents), so things like changing "easy to administer" (a fairly common phrase) to "accessible to administer" (almost never used, only a small handful of results on Google) seems to be adding complexity to the language without providing any additional clarity. @ThunderSon @mackowski any thoughts? |
|
I agree with the points discussed. It is important to keep in mind our audience, and the meaning of the sentence. |
…d in aid of clarity of language
|
@ThunderSon @rbsec Thank you greatly for your constructive comments, I perhaps jumped the gun a couple of times! In trying to make them more inclusive I perhaps could have made them less accessible to others, so thank you for casting your eyes over this change. @ThunderSon I wasn't aware that there were cheat sheets due to be archived! Sorry I missed that. I'll keep that comment handy going forward. Thank you again, both! Let me know if there are any other changes to me made. |
This change improves the inclusivity of the language in the Access Control cheat sheet.
Please let me know if I've made any errors - first time contributor!