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 >> >> >
