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 >
