Hacker News new | ask | show | jobs
by falsedan 4665 days ago
These are basic grammar mistakes. Mastery of basic grammar is achievable with a small amount of dedication; if the author does not have the time, they could ask an English-speaking acquaintance to proof-read their docs.

The author's primary (and perhaps only) contact with users is through their documentation. Incorrect capitalization and apostrophe use is distracting and will put off some potential users. The author looks sloppy and uncaring because these types of mistakes are preventable.

Being a non-native speaker is not an excuse for basic errors (excepting novices). Proof-read your docs! If you're not confident in your language skills, ask someone else to!

2 comments

if the author does not have the time, they could ask an English-speaking acquaintance to proof-read their docs.

I doubt it is the lack of time. But natively English-speaking acquaintance to proof-read technical documentation can be very hard to come by. Most projects have to do by with the folks they have. ( I am in need for such a person myself. If anyone has the time Searchdaimon ( https://github.com/searchdaimon/enterprise-search ) could need some help :) )

One trick can be to at least wikify the documentation so other can easier pitch in.

To be blunt: do you speak a second language fluently? If not, I don't think you have any idea how much dedication you're demanding.

Instead of bashing someone on hnews comments, you could send them an errata patch.

The onus is not on me to make this project's documentation presentable: it is on the author. My language skills are immaterial! The author's language skills do not excuse lazy presentation, they only help explain it.
They are material when you say that the author is being lazy for not writing English better or finding someone to contribute. It implies you don't know the difficulty of what you're asking, so why are you calling him lazy?

But of course you want to make it clear that you feel no obligation to contribute despite your criticism. So it's lazy for him, but not for you?

The grammatical errors exist regardless of whether I speak one, three, or a hundred languages fluently. Better to ask the number of projects I have documented...

Note I comment exclusively on the author's presentation, not thrir personal behavior: obviously they are not lazy. I have no obligation to contribute, no: ncome from or personal interest in this project. I contribute to the projects which benefit me and people who I care about.