Hacker News new | ask | show | jobs
by VikingCoder 4665 days ago
I wish that I had spent more time crafting my initial response. How would you have written my post, so these concepts are clear:

rgbrgb, I agree that it's superficial, but in direct contrast to your praise of the superficial style of the documentation, I was unfortunately distracted by the superficial mistakes in grammar and spelling. I wish someone would take the time to help the author of this code, Dmitry Simonenko, to improve the documentation. To that point, here are my hopefully constructive criticisms specifically of the language used in the documentation. I have performed no audit of the library itself, and cannot speak to its quality.

Does this still come off to you as poor form?

1 comments

That's much more reasonable. But I also think it's a waste of time.

The problem with the docs aren't these small gramattical errors. In most cases you cite the meaning is clear, so this is just pedantry.

What bothers me about the documentation is that the explanation of his algorithms is a bit opaque.

But all told, I'd much rather someone contribute than hold back because of concerns about language mastery.

I, like many people, get distracted by easily-corrected mistakes. You can call that a fault of mine, and people like me, but since it's relatively easy to lower the barrier for us to easily consume the material by correcting the language, I think it's worthwhile.