You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@flink.apache.org by Hermann Gábor <re...@gmail.com> on 2015/03/07 13:25:44 UTC
[DISCUSS] Documentation Java/Scala order
Hey all,
The default language for the source codes in the documentation is Java (see
the Programming Guide
<http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html>),
but in blog posts (like Introducing Flink Streaming
<http://flink.apache.org/news/2015/02/09/streaming-example.html>) Scala is
the default. I think it should be consistent.
Scala is more concise, thus it might be better for longer source codes, but
Java is more widely used.
What do you think?
It came up because we've been dealing with FLINK-1429
<https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala docs)
with Marton.
Cheers,
Gabor
Re: [DISCUSS] Documentation Java/Scala order
Posted by Maximilian Michels <mx...@apache.org>.
+1 for Scala as a default. Looks much less verbose.
On Mon, Mar 9, 2015 at 3:34 PM, Márton Balassi <ba...@gmail.com> wrote:
> Then if no objections in 24 hours I'd open a JIRA issue for this.
>
> On Mon, Mar 9, 2015 at 3:23 PM, Till Rohrmann <tr...@apache.org> wrote:
>
>> +1 for Scala :-)
>>
>> On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <ba...@gmail.com>
>> wrote:
>>
>> > I'm strongly for consistency and personally would prefer Scala as a
>> default
>> > - thus making the shorter page the default.
>> >
>> > On Sat, Mar 7, 2015 at 1:47 PM, Stephan Ewen <se...@apache.org> wrote:
>> >
>> > > I think either way is fine as long as we are consistent.
>> > >
>> > > I have a slight bias for making Scala the default.
>> > >
>> > > On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com>
>> > > wrote:
>> > >
>> > > > Hey all,
>> > > >
>> > > > The default language for the source codes in the documentation is
>> Java
>> > > (see
>> > > > the Programming Guide
>> > > > <
>> > > >
>> > >
>> >
>> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
>> > > > >),
>> > > > but in blog posts (like Introducing Flink Streaming
>> > > > <http://flink.apache.org/news/2015/02/09/streaming-example.html>)
>> > Scala
>> > > is
>> > > > the default. I think it should be consistent.
>> > > >
>> > > > Scala is more concise, thus it might be better for longer source
>> codes,
>> > > but
>> > > > Java is more widely used.
>> > > >
>> > > > What do you think?
>> > > >
>> > > > It came up because we've been dealing with FLINK-1429
>> > > > <https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala
>> > > docs)
>> > > > with Marton.
>> > > >
>> > > > Cheers,
>> > > > Gabor
>> > > >
>> > >
>> >
>>
Re: [DISCUSS] Documentation Java/Scala order
Posted by Alexander Alexandrov <al...@gmail.com>.
+1 for Scala
2015-03-09 15:34 GMT+01:00 Márton Balassi <ba...@gmail.com>:
> Then if no objections in 24 hours I'd open a JIRA issue for this.
>
> On Mon, Mar 9, 2015 at 3:23 PM, Till Rohrmann <tr...@apache.org>
> wrote:
>
> > +1 for Scala :-)
> >
> > On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <balassi.marton@gmail.com
> >
> > wrote:
> >
> > > I'm strongly for consistency and personally would prefer Scala as a
> > default
> > > - thus making the shorter page the default.
> > >
> > > On Sat, Mar 7, 2015 at 1:47 PM, Stephan Ewen <se...@apache.org> wrote:
> > >
> > > > I think either way is fine as long as we are consistent.
> > > >
> > > > I have a slight bias for making Scala the default.
> > > >
> > > > On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com>
> > > > wrote:
> > > >
> > > > > Hey all,
> > > > >
> > > > > The default language for the source codes in the documentation is
> > Java
> > > > (see
> > > > > the Programming Guide
> > > > > <
> > > > >
> > > >
> > >
> >
> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
> > > > > >),
> > > > > but in blog posts (like Introducing Flink Streaming
> > > > > <http://flink.apache.org/news/2015/02/09/streaming-example.html>)
> > > Scala
> > > > is
> > > > > the default. I think it should be consistent.
> > > > >
> > > > > Scala is more concise, thus it might be better for longer source
> > codes,
> > > > but
> > > > > Java is more widely used.
> > > > >
> > > > > What do you think?
> > > > >
> > > > > It came up because we've been dealing with FLINK-1429
> > > > > <https://issues.apache.org/jira/browse/FLINK-1429> (streaming
> Scala
> > > > docs)
> > > > > with Marton.
> > > > >
> > > > > Cheers,
> > > > > Gabor
> > > > >
> > > >
> > >
> >
>
Re: [DISCUSS] Documentation Java/Scala order
Posted by Márton Balassi <ba...@gmail.com>.
Then if no objections in 24 hours I'd open a JIRA issue for this.
On Mon, Mar 9, 2015 at 3:23 PM, Till Rohrmann <tr...@apache.org> wrote:
> +1 for Scala :-)
>
> On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <ba...@gmail.com>
> wrote:
>
> > I'm strongly for consistency and personally would prefer Scala as a
> default
> > - thus making the shorter page the default.
> >
> > On Sat, Mar 7, 2015 at 1:47 PM, Stephan Ewen <se...@apache.org> wrote:
> >
> > > I think either way is fine as long as we are consistent.
> > >
> > > I have a slight bias for making Scala the default.
> > >
> > > On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com>
> > > wrote:
> > >
> > > > Hey all,
> > > >
> > > > The default language for the source codes in the documentation is
> Java
> > > (see
> > > > the Programming Guide
> > > > <
> > > >
> > >
> >
> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
> > > > >),
> > > > but in blog posts (like Introducing Flink Streaming
> > > > <http://flink.apache.org/news/2015/02/09/streaming-example.html>)
> > Scala
> > > is
> > > > the default. I think it should be consistent.
> > > >
> > > > Scala is more concise, thus it might be better for longer source
> codes,
> > > but
> > > > Java is more widely used.
> > > >
> > > > What do you think?
> > > >
> > > > It came up because we've been dealing with FLINK-1429
> > > > <https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala
> > > docs)
> > > > with Marton.
> > > >
> > > > Cheers,
> > > > Gabor
> > > >
> > >
> >
>
Re: [DISCUSS] Documentation Java/Scala order
Posted by Till Rohrmann <tr...@apache.org>.
+1 for Scala :-)
On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <ba...@gmail.com>
wrote:
> I'm strongly for consistency and personally would prefer Scala as a default
> - thus making the shorter page the default.
>
> On Sat, Mar 7, 2015 at 1:47 PM, Stephan Ewen <se...@apache.org> wrote:
>
> > I think either way is fine as long as we are consistent.
> >
> > I have a slight bias for making Scala the default.
> >
> > On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com>
> > wrote:
> >
> > > Hey all,
> > >
> > > The default language for the source codes in the documentation is Java
> > (see
> > > the Programming Guide
> > > <
> > >
> >
> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
> > > >),
> > > but in blog posts (like Introducing Flink Streaming
> > > <http://flink.apache.org/news/2015/02/09/streaming-example.html>)
> Scala
> > is
> > > the default. I think it should be consistent.
> > >
> > > Scala is more concise, thus it might be better for longer source codes,
> > but
> > > Java is more widely used.
> > >
> > > What do you think?
> > >
> > > It came up because we've been dealing with FLINK-1429
> > > <https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala
> > docs)
> > > with Marton.
> > >
> > > Cheers,
> > > Gabor
> > >
> >
>
Re: [DISCUSS] Documentation Java/Scala order
Posted by Márton Balassi <ba...@gmail.com>.
I'm strongly for consistency and personally would prefer Scala as a default
- thus making the shorter page the default.
On Sat, Mar 7, 2015 at 1:47 PM, Stephan Ewen <se...@apache.org> wrote:
> I think either way is fine as long as we are consistent.
>
> I have a slight bias for making Scala the default.
>
> On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com>
> wrote:
>
> > Hey all,
> >
> > The default language for the source codes in the documentation is Java
> (see
> > the Programming Guide
> > <
> >
> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
> > >),
> > but in blog posts (like Introducing Flink Streaming
> > <http://flink.apache.org/news/2015/02/09/streaming-example.html>) Scala
> is
> > the default. I think it should be consistent.
> >
> > Scala is more concise, thus it might be better for longer source codes,
> but
> > Java is more widely used.
> >
> > What do you think?
> >
> > It came up because we've been dealing with FLINK-1429
> > <https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala
> docs)
> > with Marton.
> >
> > Cheers,
> > Gabor
> >
>
Re: [DISCUSS] Documentation Java/Scala order
Posted by Stephan Ewen <se...@apache.org>.
I think either way is fine as long as we are consistent.
I have a slight bias for making Scala the default.
On Sat, Mar 7, 2015 at 1:25 PM, Hermann Gábor <re...@gmail.com> wrote:
> Hey all,
>
> The default language for the source codes in the documentation is Java (see
> the Programming Guide
> <
> http://ci.apache.org/projects/flink/flink-docs-master/programming_guide.html
> >),
> but in blog posts (like Introducing Flink Streaming
> <http://flink.apache.org/news/2015/02/09/streaming-example.html>) Scala is
> the default. I think it should be consistent.
>
> Scala is more concise, thus it might be better for longer source codes, but
> Java is more widely used.
>
> What do you think?
>
> It came up because we've been dealing with FLINK-1429
> <https://issues.apache.org/jira/browse/FLINK-1429> (streaming Scala docs)
> with Marton.
>
> Cheers,
> Gabor
>