Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Vishnu Viswanath
Hi, This is my understanding of SO Documentation: 1. Any one in the community can contribute, others can validate and improve 2. Users can request a topic 3. As Max mentioned, the documentation is more example oriented and it doesn't have to be as comprehensive as the Flink's primary documentatio

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Robert Metzger
It seems that the content on SO is licensed under cc by-sa 3.0 with attribution required The Apache Legal FAQ is not completely clear about that case http://www.apache.org/legal/resolved.html#cc-sa But if we want, we could at least ask the legal PMC if we can add some of the content from SO into t

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Matthias J. Sax
I voted. It's live now. The advance of SO documentation is also, that people not familiar with Apache might do some documentation (but would never open a PR). Of course, as community, we should put the focus on web page docs. But having something additional can't hurt. From my experience, it is a

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Till Rohrmann
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 wrote: > I thought it is not about outsourcing but about

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Maximilian Michels
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 wrot

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Fabian Hueske
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

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Ravikumar Hawaldar
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 wrote: > Hi! > > This looks neat. Let's try it out. I just voted. > > Cheers, > Max > > On Sun, Sep 4,

Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-05 Thread Maximilian Michels
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 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 t

[SUGGESTION] Stack Overflow Documentation for Apache Flink

2016-09-04 Thread Vishnu Viswanath
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/documen