flink-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Till Rohrmann <trohrm...@apache.org>
Subject Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink
Date Mon, 05 Sep 2016 11:25:00 GMT
I've understood the SO documentation approach similar to what Max has said.
I see it as source of code examples which illustrate Flink concepts and
which is maintained by the SO community.

On Mon, Sep 5, 2016 at 1:09 PM, Maximilian Michels <mxm@apache.org> wrote:

> I thought it is not about outsourcing but about providing an
> example-based documentation on SO which can be easily edited by the SO
> community. The work can be fed back to the official Flink
> documentation which will always be on flink.apache.org.
>
> On Mon, Sep 5, 2016 at 12:42 PM, Fabian Hueske <fhueske@gmail.com> wrote:
> > Thanks for the suggestion Vishnu!
> > Stackoverflow documentation looks great. I like the easy contribution and
> > versioning features.
> >
> > However, I am a bit skeptical. IMO, Flink's primary documentation must be
> > hosted by Apache. Out-sourcing such an important aspect of a project to
> an
> > external service is not an option for me.
> > This would mean, that documentation on SO would be an additional /
> secondary
> > documentation. I see two potential problems with that:
> >
> > - It is duplicate effort to keep two documentations up-to-date. Adding a
> new
> > feature of changing some behavior must be documented in two places.
> > - Efforts to improve documentation might split up, i.e., the primary
> > documentation might receive less improvements and contributions.
> >
> > Of course, this is just my opinion but I think it is worth to mention
> these
> > points.
> >
> > Thanks,
> > Fabian
> >
> > 2016-09-05 12:22 GMT+02:00 Ravikumar Hawaldar
> > <ravikumar.hawaldar@gmail.com>:
> >>
> >> Hi,
> >>
> >>
> >> I just committed to apache-flink documentation on SO, one more commit
> >> required. Nice idea to document on SO Vishnu.
> >>
> >>
> >>
> >> Regards,
> >>
> >> Ravikumar
> >>
> >> On 5 September 2016 at 14:22, Maximilian Michels <mxm@apache.org>
> wrote:
> >>>
> >>> Hi!
> >>>
> >>> This looks neat. Let's try it out. I just voted.
> >>>
> >>> Cheers,
> >>> Max
> >>>
> >>> On Sun, Sep 4, 2016 at 8:11 PM, Vishnu Viswanath
> >>> <vishnu.viswanath25@gmail.com> wrote:
> >>> > Hi All,
> >>> >
> >>> > Why don't we make use of Stackoverflow's new documentation feature
to
> >>> > do
> >>> > some documentation of Apache Flink.
> >>> >
> >>> > To start, at least 5 SO users should commit to document, who has at
> >>> > least150
> >>> > reputation and have at least 1 positively scored answer in Flink tag.
> >>> >
> >>> > http://stackoverflow.com/documentation/apache-flink
> >>> >
> >>> > Regards,
> >>> > Vishnu Viswanath
> >>
> >>
> >
>

Mime
View raw message