search

MicrosoftDocs / microsoft-style-guide

Public contribution for Microsoft Style Guide
Creative Commons Attribution 4.0 International
177 stars 88 forks source link

ESL Challenge #66

Open gbltraveler opened 5 years ago

gbltraveler commented 5 years ago

I'm not an English language expert, but I have spent a fair amount of time working with classrooms of learners who are using English as a second language. I am wondering if using, "Bigger, fewer words", really works for a reader who is looking at documentation as an English as a second language consumer? My sense is that does not, but only anecdotal evidence. Anyway, I thought it worth mentioning. Thanks.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

LLawsonBruton commented 4 years ago

I agree. I write for an international audience and I do everything I can to keep the words to 2 syllables or less.