Mailing-List: contact user-help@flink.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@flink.apache.org
MIME-Version: 1.0
In-Reply-To: <CAMr6W6NDDH8at_1QbH2NGLJMfjSCbBiVnkMvYnSY_bDOyPKKxw@mail.gmail.com>
References: <CAK2z7j4QxPzAa0yCaYC291hAthF1O9L0z7BjOtyVwaHg1FzcMA@mail.gmail.com>
 <CAGco--YP=gknO2kP1Q4yEFVMOhcT6mRnLp_z1110B6jgrTTyKg@mail.gmail.com> <CAMr6W6NDDH8at_1QbH2NGLJMfjSCbBiVnkMvYnSY_bDOyPKKxw@mail.gmail.com>
From: Fabian Hueske <fhueske@gmail.com>
Date: Mon, 5 Sep 2016 12:42:44 +0200
Message-ID: <CAAdrtT3bY2RiKUb2pb8eKbbKtwCZCvFi5eDwXbGbyd2D8c-YQQ@mail.gmail.com>
Subject: Re: [SUGGESTION] Stack Overflow Documentation for Apache Flink
To: user@flink.apache.org
Content-Type: multipart/alternative; boundary=001a11442f44e8ebea053bc05893
archived-at: Mon, 05 Sep 2016 10:43:21 -0000

--001a11442f44e8ebea053bc05893
Content-Type: text/plain; charset=UTF-8

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

--001a11442f44e8ebea053bc05893
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div><div><div><div><div>Thanks for the suggestion Vishnu!=
 <br>Stackoverflow documentation looks great. I like the easy contribution =
and versioning features.<br><br></div>However,
 I am a bit skeptical. IMO, Flink&#39;s primary documentation must be hoste=
d
 by Apache. Out-sourcing such an important aspect of a project to an=20
external service is not an option for me.<br>This would mean, that=20
documentation on SO would be an additional / secondary documentation. I=20
see two potential problems with that:<br></div><br>- It is duplicate=20
effort to keep two documentations up-to-date. Adding a new feature of=20
changing some behavior must be documented in two places.<br>- Efforts to
 improve documentation might split up, i.e., the primary documentation=20
might receive less improvements and contributions.<br><br></div>Of course, =
this is just my opinion but I think it is worth to mention these points.<br=
><br></div>Thanks,<br></div>Fabian</div><div class=3D"gmail_extra"><br><div=
 class=3D"gmail_quote">2016-09-05 12:22 GMT+02:00 Ravikumar Hawaldar <span =
dir=3D"ltr">&lt;<a href=3D"mailto:ravikumar.hawaldar@gmail.com" target=3D"_=
blank">ravikumar.hawaldar@gmail.com</a>&gt;</span>:<br><blockquote class=3D=
"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding=
-left:1ex"><div dir=3D"ltr">Hi,<br><br><br>I just committed to apache-flink=
 documentation on SO, one more commit required. Nice idea to document on SO=
 Vishnu.<br><br><br><br>Regards,<br><br>Ravikumar</div><div class=3D"HOEnZb=
"><div class=3D"h5"><div class=3D"gmail_extra"><br><div class=3D"gmail_quot=
e">On 5 September 2016 at 14:22, Maximilian Michels <span dir=3D"ltr">&lt;<=
a href=3D"mailto:mxm@apache.org" target=3D"_blank">mxm@apache.org</a>&gt;</=
span> wrote:<br><blockquote class=3D"gmail_quote" style=3D"margin:0 0 0 .8e=
x;border-left:1px #ccc solid;padding-left:1ex">Hi!<br>
<br>
This looks neat. Let&#39;s try it out. I just voted.<br>
<br>
Cheers,<br>
Max<br>
<div><div><br>
On Sun, Sep 4, 2016 at 8:11 PM, Vishnu Viswanath<br>
&lt;<a href=3D"mailto:vishnu.viswanath25@gmail.com" target=3D"_blank">vishn=
u.viswanath25@gmail.com</a>&gt; wrote:<br>
&gt; Hi All,<br>
&gt;<br>
&gt; Why don&#39;t we make use of Stackoverflow&#39;s new documentation fea=
ture to do<br>
&gt; some documentation of Apache Flink.<br>
&gt;<br>
&gt; To start, at least 5 SO users should commit to document, who has at le=
ast150<br>
&gt; reputation and have at least 1 positively scored answer in Flink tag.<=
br>
&gt;<br>
&gt; <a href=3D"http://stackoverflow.com/documentation/apache-flink" rel=3D=
"noreferrer" target=3D"_blank">http://stackoverflow.com/docum<wbr>entation/=
apache-flink</a><br>
&gt;<br>
&gt; Regards,<br>
&gt; Vishnu Viswanath<br>
</div></div></blockquote></div><br></div>
</div></div></blockquote></div><br></div>

--001a11442f44e8ebea053bc05893--