3 ms·

I'm not sure it it's a good idea to start with a word play: > Well, you’ve come to the write [sic] place. I believe that most readers of that site will be non

by vog 12y ago

I'm not sure it it's a good idea to start with a word play: > Well, you’ve come to the write [sic] place. I believe that most readers of that site will be non-native speakers, who may or may not get such in-language jokes. Also, what I'm missing most is not how to structure text, but a concise(!) overview of the most important grammar rules, i.e. stuff that can't be easily checked via dict.cc or similar sites. Are there any plans to extend the site in this direction?

roryokane 12y ago
I can’t think of any grammar rules that are more applicable to documentation than to other writing. Thus, I think giving an overview of grammar rules would be out-of-scope for this site, and shouldn’t be added. However, it might be in scope for this site to have an appendix with a list of links about writing in general, and such a grammar site would deserve a spot. > I believe that most readers of that site will be non-native speakers I don’t see why this site would get a higher proportion of non-native speakers than any other site. Learning to understand a language and learning to write well in it are mostly separate things, and I think native speakers will understand that, so they won’t avoid using this site just because it’s about writing in English. Or are you saying that there are more non-native-speaker users in general who browse English programming sites than native-speaker users?
krick 12y ago
> I believe that most readers of that site will be non-native speakers, who may or may not get such in-language jokes. Doesn't look like a big problem to me. I'm non-native speaker myself and I got the joke just fine, even though I didn't find it very amusing. And even if I wouldn't, I'd just skip that sentence without worrying too much about it (probably thinking it means "place for writing" or something like that).
- vog 12y ago
  Don't get me wrong. I'm not a native English speaker, either. And I got that joke, too. However, it still felt out of place there.

by vog 12y ago

roryokane 12y ago

I can’t think of any grammar rules that are more applicable to documentation than to other writing. Thus, I think giving an overview of grammar rules would be out-of-scope for this site, and shouldn’t be added. However, it might be in scope for this site to have an appendix with a list of links about writing in general, and such a grammar site would deserve a spot. > I believe that most readers of that site will be non-native speakers I don’t see why this site would get a higher proportion of non-native speakers than any other site. Learning to understand a language and learning to write well in it are mostly separate things, and I think native speakers will understand that, so they won’t avoid using this site just because it’s about writing in English. Or are you saying that there are more non-native-speaker users in general who browse English programming sites than native-speaker users?

krick 12y ago

> I believe that most readers of that site will be non-native speakers, who may or may not get such in-language jokes. Doesn't look like a big problem to me. I'm non-native speaker myself and I got the joke just fine, even though I didn't find it very amusing. And even if I wouldn't, I'd just skip that sentence without worrying too much about it (probably thinking it means "place for writing" or something like that).

vog 12y ago
Don't get me wrong. I'm not a native English speaker, either. And I got that joke, too. However, it still felt out of place there.