Hi Sheng, Thanks again for the experience sharing! Yes I agree that translators would leave the community quicker code contributors.
I rethink my opinions a bit. If we would discard Chinese doc sooner or later, it's better to discard them now, so we could pay less attention to it. I do care too much about the sunk cost before. Changed to agree. Best, Shuyang Sheng Wu <[email protected]> 于2021年1月21日周四 下午9:53写道： > Hi Shuyang > > Please don't get me wrong. > Of course, multi-language documents are useful. It is friendly to Chinese > local new contributors, especially open source is new to them. > And I also want to point out, the translator(also contributor for sure) > usually leave the community quicker than code contributors(This is not > discrimination). The reason is, once the first version of translation > completed, maintenance is very boring :P > I was the official Chinese documentation provider for OpenTracing(CNCF > project), but I left in 2 months after finishing it. > > Again, this is only my personal experience. If the committer team(including > PMC) doesn't want to work on it, I am supporting them. > > Sheng Wu 吴晟 > Twitter, wusheng1108 > > > Shuyang Wu <[email protected]> 于2021年1月21日周四 下午9:45写道： > > > Hi Sheng, > > > > Thank you for your experience sharing! That indeed makes sense to me, > that > > a survey in the community might not give us effective information, since > > "something is always better than nothing". And indeed the functionality > and > > community are way more important than localized documentation. > > > > But the less importance doesn't mean it's useless. I just think it is not > > the time for us to abandon Chinese docs, since it seems still not a > burden > > to the community. If I make it right, 3 out of ~60 pages of doc are only > in > > English, 1 out of 15 doc related issues are about Chinese doc. I think > > that's acceptable for the community to fix. So unless someone told me > s/he > > is tired of fix Chinese doc issues (to make it so little), I'll still > hold > > my point. (otherwise I'll praise her/him as a hero and directly +1 :) > > > > And for what could we benefit from that, I could find some first-time > > contributors trying to use a Chinese version doc as their first PR. > What's > > more, although the only requirement for documentation is clear, that's > > enough, people are still trying to create Chinese documentation of k8s, > > envoy and all those common tools. We have to say convenience could make > > people have easier access to the tool and the community. Localization is > > not necessary, but it's still important, and beneficial. > > > > Best, > > Shuyang > > > > > > YuanSheng Wang <[email protected]> 于2021年1月21日周四 下午5:30写道： > > > > > > people choose a project because it is powerful, useful, fixing > > > > their real issues, rather than having Chinese documentations. > > > > > > I love it. > > > > > > > > > On Thu, Jan 21, 2021 at 5:19 PM Sheng Wu <[email protected]> > > > wrote: > > > > > > > Hi all > > > > > > > > I want to share a little experience from Apache SkyWalking, which > used > > to > > > > have dual language documentation, but not anymore for 2 years. > > > > At first, some users may complain about this, and saying it is hard > to > > > > understand. If you run a survey to the community, this reason will > turn > > > > out. > > > > But with time, you will notice, people are getting used to it, and > > Google > > > > translation is powerful enough for understanding the document. (the > > same > > > > story, you said acceptable for not-Chinese-speaker). > > > > > > > > If the APISIX community wants to lower the load of maintaining dual > > > > languages, don't need to have a concern about losing users, because, > in > > > > reality, people choose a project because it is powerful, useful, > fixing > > > > their real issues, rather than having Chinese documentations. > > > > > > > > Sheng Wu 吴晟 > > > > Twitter, wusheng1108 > > > > > > > > > > > > Ming Wen <[email protected]> 于2021年1月21日周四 下午5:05写道： > > > > > > > > > yes, this is the discuss thread, and mailinglist is the public > > channel > > > > too. > > > > > welcome everyone join us. > > > > > > > > > > Thanks, > > > > > Ming Wen, Apache APISIX PMC Chair > > > > > Twitter: _WenMing > > > > > > > > > > > > > > > Shuyang Wu <[email protected]> 于2021年1月21日周四 下午5:02写道： > > > > > > > > > > > I'm not so sure about this, maybe we need some feedback from our > > > users > > > > > but > > > > > > not just ourselves. > > > > > > > > > > > > Since the main part of our users (as found in PoweredBy) are from > > > > China, > > > > > I > > > > > > think people could benefit some from Chinese docs. Besides, most > of > > > our > > > > > > contributors are from China (although the ratio is becoming > less), > > it > > > > > would > > > > > > not be hard for Chinese contributors to maintain doc in both > > > languages. > > > > > If > > > > > > contributors are not from China, making the translation a > > > > > good-first-issue > > > > > > is also acceptable (as what we're doing right now). Or at first, > we > > > > could > > > > > > use the machine-translated version until someone finds it > annoying > > > > enough > > > > > > to fix it. > > > > > > > > > > > > Best, > > > > > > Shuyang > > > > > > > > > > > > YuanSheng Wang <[email protected]> 于2021年1月21日周四 下午4:04写道： > > > > > > > > > > > > > agree this, my +1 > > > > > > > > > > > > > > > > > > > > > On Thu, Jan 21, 2021 at 3:55 PM Ming Wen <[email protected]> > > > wrote: > > > > > > > > > > > > > > > hello, devs, > > > > > > > > APISIX was originally donated to the Apache Foundation by > > Chinese > > > > > > company > > > > > > > > and developers, so both Chinese and English documents are > > > > maintained. > > > > > > > > > > > > > > > > Now with the rapid growth of features and contributors, > > > maintaining > > > > > two > > > > > > > > documents at the same time will bring additional work to > > > > > contributors. > > > > > > > > > > > > > > > > So I propose to maintain only English documents and discard > > > Chinese > > > > > > > > documents. > > > > > > > > > > > > > > > > What do you think? > > > > > > > > > > > > > > > > Thanks, > > > > > > > > Ming Wen, Apache APISIX PMC Chair > > > > > > > > Twitter: _WenMing > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > > > > > > > *MembPhis* > > > > > > > My GitHub: https://github.com/membphis > > > > > > > Apache APISIX: https://github.com/apache/apisix > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > *MembPhis* > > > My GitHub: https://github.com/membphis > > > Apache APISIX: https://github.com/apache/apisix > > > > > >
