4 ms·
I used to think English was useless too until I had to read other people's documentation. The world would be a better place if smart programmers were also compe
by 2muchcoffeeman 10y ago
I used to think English was useless too until I had to read other people's documentation. The world would be a better place if smart programmers were also competent at writing documentation and comments.
I've seen crazy things like punctuation placed in the middle of a sentence. I had to ask, "Is this one sentence or two?" People not using appropriate paragraphs, no headings, rambling sentences etc ...
A little bit of proof reading, editing and formatting goes a long way.
- kiba 10y agoI didn't say English is a useless language. It's a very useful language, but I doubt a Japanese classroom is a good place to become a good English speaker and user.
- 2muchcoffeeman 10y agoWait, are you talking about teaching English in Japan? I read that as teaching an English class in an English speaking country!
- imtringued 10y agoIf we didn't have an English class in an English speaking country nobody would know how to write.
- spacecowboy_lon 10y agoNot sure what you meant using punctuation in the middle of a sentence is used for clarity e.g. using commas and dashes. Your not wrong about how documentation is poor - look at a lot of Google's API docs most of it is poor and incomplete.