[DISCUSS] Add Translation Specification for Stateful Functions

[Congxian Qiu]

Hi all,


As Stateful Functions continues to evolve, and there have been many
attempts by Chinese users. I propose to add a translation specification for
Stateful Functions like the Translation Specification for Apache
Flink[1](the proposed translation specification[2] is written in Chinese,
we can convert it into other languages if needed). The purpose is to
improve the translation quality, reduce the workload of the reviewer, keep
the style consistent, and make the reader’s reading experience better.


I would also propose to convert it into a WIKI page when it is accepted,
and link it from the contribute documentation page[2]


Please feel free to join the discussion and give some feedback.


[1]
https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications

[2]
https://docs.google.com/document/d/1Fv56PG50pHlDxZfF49iRhv-8dY7ZaCSHUCvBM2Vy0ao

[3] https://flink.apache.org/contributing/docs-style.html


Best,
Congxian

[Yu Li]

+1 for adding the translation specification for stateful functions.

Thanks for driving the discussion Congxian!

Best Regards,
Yu


On Fri, 9 Oct 2020 at 15:55, Congxian Qiu <[hidden email]> wrote:

> Hi all,
>
>
> As Stateful Functions continues to evolve, and there have been many
> attempts by Chinese users. I propose to add a translation specification for
> Stateful Functions like the Translation Specification for Apache
> Flink[1](the proposed translation specification[2] is written in Chinese,
> we can convert it into other languages if needed). The purpose is to
> improve the translation quality, reduce the workload of the reviewer, keep
> the style consistent, and make the reader’s reading experience better.
>
>
> I would also propose to convert it into a WIKI page when it is accepted,
> and link it from the contribute documentation page[2]
>
>
> Please feel free to join the discussion and give some feedback.
>
>
> [1]
>
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
>
> [2]
>
> https://docs.google.com/document/d/1Fv56PG50pHlDxZfF49iRhv-8dY7ZaCSHUCvBM2Vy0ao
>
> [3] https://flink.apache.org/contributing/docs-style.html
>
>
> Best,
> Congxian
>

[Jark Wu-2]

Thanks for driving the discussion Congxian!

I'm +1 for adding translation specifications for stateful functions.

What about merging the proposed translation specifications into the
existing document [1]?
It seems the new specifications only add some terminology translation for
the glossary.
Most of the content can be shared with the existing translation
specifications, e.g. the translation guidelines.

[1]:
https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications

On Fri, 9 Oct 2020 at 16:34, Yu Li <[hidden email]> wrote:

> +1 for adding the translation specification for stateful functions.
>
> Thanks for driving the discussion Congxian!
>
> Best Regards,
> Yu
>
>
> On Fri, 9 Oct 2020 at 15:55, Congxian Qiu <[hidden email]> wrote:
>
> > Hi all,
> >
> >
> > As Stateful Functions continues to evolve, and there have been many
> > attempts by Chinese users. I propose to add a translation specification
> for
> > Stateful Functions like the Translation Specification for Apache
> > Flink[1](the proposed translation specification[2] is written in Chinese,
> > we can convert it into other languages if needed). The purpose is to
> > improve the translation quality, reduce the workload of the reviewer,
> keep
> > the style consistent, and make the reader’s reading experience better.
> >
> >
> > I would also propose to convert it into a WIKI page when it is accepted,
> > and link it from the contribute documentation page[2]
> >
> >
> > Please feel free to join the discussion and give some feedback.
> >
> >
> > [1]
> >
> >
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
> >
> > [2]
> >
> >
> https://docs.google.com/document/d/1Fv56PG50pHlDxZfF49iRhv-8dY7ZaCSHUCvBM2Vy0ao
> >
> > [3] https://flink.apache.org/contributing/docs-style.html
> >
> >
> > Best,
> > Congxian
> >
>

[Tzu-Li (Gordon) Tai]

+1 to merging the specification to the existing Flink translation
specifications.

We also have an open translation PR that is pending on an official
translation specification for StateFun to be available:
https://github.com/apache/flink-statefun/pull/131

Cheers,
Gordon

On Fri, Oct 9, 2020 at 4:52 PM Jark Wu <[hidden email]> wrote:

> Thanks for driving the discussion Congxian!
>
> I'm +1 for adding translation specifications for stateful functions.
>
> What about merging the proposed translation specifications into the
> existing document [1]?
> It seems the new specifications only add some terminology translation for
> the glossary.
> Most of the content can be shared with the existing translation
> specifications, e.g. the translation guidelines.
>
> [1]:
>
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
>
> On Fri, 9 Oct 2020 at 16:34, Yu Li <[hidden email]> wrote:
>
> > +1 for adding the translation specification for stateful functions.
> >
> > Thanks for driving the discussion Congxian!
> >
> > Best Regards,
> > Yu
> >
> >
> > On Fri, 9 Oct 2020 at 15:55, Congxian Qiu <[hidden email]>
> wrote:
> >
> > > Hi all,
> > >
> > >
> > > As Stateful Functions continues to evolve, and there have been many
> > > attempts by Chinese users. I propose to add a translation specification
> > for
> > > Stateful Functions like the Translation Specification for Apache
> > > Flink[1](the proposed translation specification[2] is written in
> Chinese,
> > > we can convert it into other languages if needed). The purpose is to
> > > improve the translation quality, reduce the workload of the reviewer,
> > keep
> > > the style consistent, and make the reader’s reading experience better.
> > >
> > >
> > > I would also propose to convert it into a WIKI page when it is
> accepted,
> > > and link it from the contribute documentation page[2]
> > >
> > >
> > > Please feel free to join the discussion and give some feedback.
> > >
> > >
> > > [1]
> > >
> > >
> >
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
> > >
> > > [2]
> > >
> > >
> >
> https://docs.google.com/document/d/1Fv56PG50pHlDxZfF49iRhv-8dY7ZaCSHUCvBM2Vy0ao
> > >
> > > [3] https://flink.apache.org/contributing/docs-style.html
> > >
> > >
> > > Best,
> > > Congxian
> > >
> >
>

[Congxian Qiu]

Thanks all for the positive feedback.

merging the proposed translation specification into the existing document
is better. In that form, people can find the specification on one page,
it's more convenient。

I'll start a separate email for the vote.

Best,
Congxian


Tzu-Li (Gordon) Tai <[hidden email]> 于2020年10月12日周一 下午12:57写道：

> +1 to merging the specification to the existing Flink translation
> specifications.
>
> We also have an open translation PR that is pending on an official
> translation specification for StateFun to be available:
> https://github.com/apache/flink-statefun/pull/131
>
> Cheers,
> Gordon
>
> On Fri, Oct 9, 2020 at 4:52 PM Jark Wu <[hidden email]> wrote:
>
> > Thanks for driving the discussion Congxian!
> >
> > I'm +1 for adding translation specifications for stateful functions.
> >
> > What about merging the proposed translation specifications into the
> > existing document [1]?
> > It seems the new specifications only add some terminology translation for
> > the glossary.
> > Most of the content can be shared with the existing translation
> > specifications, e.g. the translation guidelines.
> >
> > [1]:
> >
> >
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
> >
> > On Fri, 9 Oct 2020 at 16:34, Yu Li <[hidden email]> wrote:
> >
> > > +1 for adding the translation specification for stateful functions.
> > >
> > > Thanks for driving the discussion Congxian!
> > >
> > > Best Regards,
> > > Yu
> > >
> > >
> > > On Fri, 9 Oct 2020 at 15:55, Congxian Qiu <[hidden email]>
> > wrote:
> > >
> > > > Hi all,
> > > >
> > > >
> > > > As Stateful Functions continues to evolve, and there have been many
> > > > attempts by Chinese users. I propose to add a translation
> specification
> > > for
> > > > Stateful Functions like the Translation Specification for Apache
> > > > Flink[1](the proposed translation specification[2] is written in
> > Chinese,
> > > > we can convert it into other languages if needed). The purpose is to
> > > > improve the translation quality, reduce the workload of the reviewer,
> > > keep
> > > > the style consistent, and make the reader’s reading experience
> better.
> > > >
> > > >
> > > > I would also propose to convert it into a WIKI page when it is
> > accepted,
> > > > and link it from the contribute documentation page[2]
> > > >
> > > >
> > > > Please feel free to join the discussion and give some feedback.
> > > >
> > > >
> > > > [1]
> > > >
> > > >
> > >
> >
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Translation+Specifications
> > > >
> > > > [2]
> > > >
> > > >
> > >
> >
> https://docs.google.com/document/d/1Fv56PG50pHlDxZfF49iRhv-8dY7ZaCSHUCvBM2Vy0ao
> > > >
> > > > [3] https://flink.apache.org/contributing/docs-style.html
> > > >
> > > >
> > > > Best,
> > > > Congxian
> > > >
> > >
> >
>