News for hackers. Stuff that matters.
Re:Electron is flash for the desktop (2016) by franciscop on Tuesday April 11, 2017 @10:46AM (#14088280)
Well it depends on how much you have worked with a person who was still learning English. For me it highly depends on the kind of typos:

- They're vs Their and similar normally denote uneducated native English speaker. The code might still be okay, but these typos passing to production makes me check code quality in case some similar QA mistakes are passed in the code.

- Grammar mistakes normally show a foreigner for whom English is not the main language. A small example just in the first line, "to create apps, games that run" => "to create apps and games that run", but this is normally due to a different language constructions. Similar to graphical softwares => graphical software.

So, kudos for OP to write the documentation in a non-native language! (upon light investigation it seems the main writer is French and his coworkers fix typos from time to time).

Re:Electron is flash for the desktop (2016) by merb on Tuesday April 11, 2017 @11:24AM (#14088772)
> They're vs Their and similar normally denote uneducated native English speaker.

in germany only grammar nazi's would actually hate such things. they are too common, to say that only uneducated people do it. people who write code and distribute code to the whole world are not writers, there is no need for "perfect" grammar and typos. i mean in my first application i've written quanity instead of quantity (inside the code), somehow it slipped in a lot of places, but i think many many people who will read the code would still understand it. as long as the user interface is checked, i think it's okay if the readme/documentation has typos or grammar mistakes (on open source projects). the most important thing is, is that people understand each other/understand what it's all about. which is just fine for nidium.

Re:Electron is flash for the desktop (2016) by franciscop on Tuesday April 11, 2017 @11:44AM (#14089062)
Really? I have seen it in many "comment sites" but rarely see it in technical documentation and blog posts. And I don't hate that at all! I'm just pointing out that someone who makes these kind of mistake is probably native and that a large number of these typos indicate that:

- The writer didn't do proofreading (or did it but is not aware of the mistake).

- It's made by a single person with no one else to check on the documentation.

Now while they are not technically a display of low code quality, they are normally indicative of low attention to detail and lonely programming, which is not the optimal situation for high code quality. For people using English as the second language I'm a lot more forgiving since they and their coworkers might not even know how to properly express some things due to translation issues (and not due to lack of proofreading/lonely programming).

In my experience when I'm doing proofreading of my own libraries I also catch ambiguous sentences, lacking documentation or examples and many other things that could be improved upon.