Re: [DISCUSS] How do we deal with the Chinese documents?

[Jian Tan <ta...@apache.org>]

Hi, Skywalking community:

Two weeks have passed since the last discussion about how to deal with
Chinese documents with Skywalking main repo.

And In the beginning, considering developers or open source users
uses Skywalking, I also began to consider providing Chinese documents.

During this, other contributors are also participating in it. But it needs
much effort indeed.

After discussion with committers or PPMC, we decide to remove those
incomplete Chinese docs to avoid more misguidances.

After that, it's still based on officially available English documents.

More info[1].

[1] https://github.com/apache/incubator-skywalking/pull/2315



吴晟 Sheng Wu <wu...@foxmail.com> 于2019年2月20日周三 下午10:00写道：

> Hi York and Willem
>
>
> I also wanted to keep Chinese document there. But the complaints come.
> Every Chinese user finds out cn version provided, then go into, see
> **TODO** there.
> So they assume no document provided.
>
>
> Even we put notice at the top of page
> **注：中文文档由社区志愿者提供，官方文档以英文为准。**(Only English documentations are official
> documents).
>
>
> Still receive a lot of them. If no one says he will lead that part, at
> least finish them recently, I think at least we need to remove them to
> avoid more misguidances.
>
>
> ------------------
> Sheng Wu
> Apache SkyWalking, ShardingSphere, Zipkin
> Twitter, wusheng1108
>
>
>
>
>
>
>
> ------------------ Original ------------------
> From:  "York Shen"<ky...@apache.org>;
> Date:  Wed, Feb 20, 2019 06:00 PM
> To:  "dev"<de...@skywalking.apache.org>;
>
> Subject:  Re: [DISCUSS] How do we deal with the Chinese documents?
>
>
>
> As a committer of Apache weex, I found it useful to maintain both Chinese
> and English document, though it is really time consuming.
>
> Best Regards,
> YorkShen
>
> 申远
>
> On 2019/02/20 07:03:47, Jian Tan <ta...@apache.org> wrote:
> > Considering that users in China still need Chinese documents more, I
> think
> > we can migrate Chinese documents to the SKYAPM community to reduce the
> > maintenance cost of the main repo.
> >
> > 吴晟 Sheng Wu <wu...@foxmail.com> 于2019年2月20日周三 下午2:44写道：
> >
> > > Hi.
> > >
> > >
> > > In these several months, I received a lot of feedback about `SkyWalking
> > > doesn't provide deploy document`.
> > > After I dig into why they say that, they mean `SkyWalking Chinese
> document
> > > is in TODO` status.
> > >
> > >
> > > In my document page, we have a very clear link to Chinese document[1],
> but
> > > no many things in it.
> > > This really misguide the new incomers.
> > >
> > >
> > > I want to know, what should we do for that? I think we have two options
> > > 1. Remove that link and related Chinese documents, provide official
> > > English document and English only.
> > > 2. Some volunteers(committer better) could lead all the translation
> works,
> > > and sync to the English version before every release.
> > >
> > >
> > > [1]
> > >
> https://github.com/apache/incubator-skywalking/blob/master/docs/README.md
> > >
> > >
> > > ------------------
> > > Sheng Wu
> > > Apache SkyWalking, ShardingSphere, Zipkin
> > > Twitter, wusheng1108
> >
> >
> >
> > --
> > Jian Tan
> > Apache SkyWalking Committer, DaoCloud Labs
> > Twitter, @tanjian2015
> >



-- 
Jian Tan
Apache SkyWalking Committer, DaoCloud Labs
Twitter, @tanjian2015