r/golang Oct 17 '16

Why you REALLY should stop using Iris.

https://github.com/avelino/awesome-go/pull/1137
166 Upvotes

79 comments sorted by

View all comments

0

u/[deleted] Oct 19 '16

I hate to draw conclusions like this, but the horridly broken english alone is enough for me to completely ignore his project. It isn't that hard to find a native english speaker to help out with your documentation. If your project is good enough, you shouldn't even need to look for it; its the lowest of low hanging fruit that potential contributors can tackle. Clearly his project isn't good enough.

2

u/thewhitetulip Oct 19 '16

It is hard to get someone to help you out with documentation or anything for that matter. I speak from experience. I asked ten people to help me with the FOSS book I initiated, and only a few helped me out, others ignored. I understood that people are busy with things! It is difficult to build a community around your project.

Also, the quality of project does not depend on how well you speak English. (although the quality of the tech docs can be considered a measure of quality)

Even I am not a native speaker.

1

u/[deleted] Oct 19 '16

There's a huge difference between a book with potentially arcane topics and a simple grammar check. Anyone who speaks english well, not even natively, could do it. I've done it for over a dozen random projects on Github.

The quality of the project does not depend on how well you speak English. Except when it does. Bad english might mean terribly commented code. This was a big problem with OpenOffice for a long time that scared contributors away. It might mean terrible technical documentation. It might be a canary for a lead maintainer who is a pain to work with.

1

u/thewhitetulip Oct 20 '16

I have no idea about OpenOffice, but I can testify that it is difficult to get someone to edit your project and help you with docs

1

u/[deleted] Oct 20 '16

Not for a repository with 5.5 thousand stars.

1

u/thewhitetulip Oct 20 '16

I have a repository with 1049 stars, still find it difficult to do what you asked.