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 <m...@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 <fhue...@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.hawal...@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 <m...@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.viswanat...@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 > >> > >> > > >
