News for hackers. Stuff that matters.
Re:Electron is flash for the desktop (2016) by Etheryte on Tuesday April 11, 2017 @10:34AM (#14088156)
Both your webpage and your docs are riddled with typos and the like. While it isn't indicative of code or project quality, it sure makes taking the project seriously a lot harder.
Re:Electron is flash for the desktop (2016) by paraboul on Tuesday April 11, 2017 @10:37AM (#14088184)
Hey,

We're French and it's indeed hard for us to get this perfectly right and focusing on the project itself at the same time.

We're planning to move this to github in order to let the community help us on this.

Re:Electron is flash for the desktop (2016) by acuozzo on Tuesday April 11, 2017 @11:37AM (#14088950)
I'm more than willing to help edit the English you write for this project. Let me know if you're interested.
Re:Electron is flash for the desktop (2016) by paraboul on Tuesday April 11, 2017 @11:52AM (#14089193)
Definitely! My email is my HN handle at gmail
Re:Electron is flash for the desktop (2016) by saosebastiao on Tuesday April 11, 2017 @12:19PM (#14089575)
Hey, I think you're doing the right thing, in 1) asking for help from the community in an area where you feel lacking, and 2) by making it available to the best your ability. Many projects fail at one of those two, which dooms them to never have a community. Keep up the good work.
Re:Electron is flash for the desktop (2016) by JustSomeNobody on Tuesday April 11, 2017 @10:42AM (#14088242)
Just because I'm curious, why would you not use your native language for the content on your page?
Re:Electron is flash for the desktop (2016) by paraboul on Tuesday April 11, 2017 @10:46AM (#14088283)
nidium is an open source tech project not a local product.
Re:Electron is flash for the desktop (2016) by poirier on Tuesday April 11, 2017 @11:35AM (#14088904)
Starred because your answers here are beautiful.
Re:Electron is flash for the desktop (2016) by collyw on Tuesday April 11, 2017 @12:05PM (#14089390)
Because English is the most spoken language in the world perhaps? Its even more noticeable in tech, because a lot of docs only seem to be in English.
Re:Electron is flash for the desktop (2016) by jwilk on Tuesday April 11, 2017 @04:45PM (#14092262)
I'm pretty sure the most spoken language is Chinese.
Re:Electron is flash for the desktop (2016) by abiox on Tuesday April 11, 2017 @05:07PM (#14092452)
chinese is the most spoken native language.

english is the most spoken secondary language.

Re:Electron is flash for the desktop (2016) by blueprint on Tuesday April 11, 2017 @10:45AM (#14088275)
Seems an easy question. English is basically a/the global language. If you want a massive portion of the community to find the content inaccessible, making it available only in French is a good way to do so.
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.