[DISCUSS] Documentation Java/Scala order

[Hermann Gábor]

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

[Stephan Ewen]

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 <[hidden email]> 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
>

[Márton Balassi]

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 <[hidden email]> 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 <[hidden email]>
> 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
> >
>

[Till Rohrmann]

+1 for Scala :-)

On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <[hidden email]>
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 <[hidden email]> 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 <[hidden email]>
> > 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
> > >
> >
>

[Márton Balassi]

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 <[hidden email]> wrote:

> +1 for Scala :-)
>
> On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <[hidden email]>
> 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 <[hidden email]> 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 <[hidden email]>
> > > 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
> > > >
> > >
> >
>

[aalexandrov]

+1 for Scala

2015-03-09 15:34 GMT+01:00 Márton Balassi <[hidden email]>:

> 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 <[hidden email]>
> wrote:
>
> > +1 for Scala :-)
> >
> > On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <[hidden email]
> >
> > 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 <[hidden email]> 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 <[hidden email]>
> > > > 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
> > > > >
> > > >
> > >
> >
>

[mxm]

+1 for Scala as a default. Looks much less verbose.

On Mon, Mar 9, 2015 at 3:34 PM, Márton Balassi <[hidden email]> 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 <[hidden email]> wrote:
>
>> +1 for Scala :-)
>>
>> On Sat, Mar 7, 2015 at 1:56 PM, Márton Balassi <[hidden email]>
>> 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 <[hidden email]> 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 <[hidden email]>
>> > > 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
>> > > >
>> > >
>> >
>>