You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@flink.apache.org by Maximilian Alber <al...@gmail.com> on 2015/06/23 17:09:21 UTC

Documentation Error

Hi Flinksters,

just some minor:
http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
in the second code sample should be

./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar

instead of:

./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar


Cheers,
Max

Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
Ok wasn't sure if the +1 were just for the FAQ.

On Wed, Jul 1, 2015 at 11:30 AM, Ufuk Celebi <uc...@apache.org> wrote:

>
> On 01 Jul 2015, at 11:26, Maximilian Michels <mx...@apache.org> wrote:
>
> > I removed the FAQ from the main repository and merged it with the
> website's version.
> >
> > There is still the duplicate "How to Contribute" guide. It suffers from
> the same sync problem.
>
> Just remove it as well. Don't need another round of +1s. It's essentially
> the same problem.

Re: Documentation Error

Posted by Ufuk Celebi <uc...@apache.org>.
On 01 Jul 2015, at 11:26, Maximilian Michels <mx...@apache.org> wrote:

> I removed the FAQ from the main repository and merged it with the website's version. 
> 
> There is still the duplicate "How to Contribute" guide. It suffers from the same sync problem.

Just remove it as well. Don't need another round of +1s. It's essentially the same problem.

Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
I removed the FAQ from the main repository and merged it with the website's
version.

There is still the duplicate "How to Contribute" guide. It suffers from the
same sync problem.

On Tue, Jun 30, 2015 at 7:04 PM, Stephan Ewen <se...@apache.org> wrote:

> +1
> for moving the FAQ to the website.
>
> On Tue, Jun 30, 2015 at 5:09 PM, Robert Metzger <rm...@apache.org>
> wrote:
>
>> +1
>> lets remove the FAQ from the source repo and put it on the website only.
>>
>> On Thu, Jun 25, 2015 at 3:14 PM, Ufuk Celebi <uc...@apache.org> wrote:
>>
>>>
>>> On 25 Jun 2015, at 14:31, Maximilian Michels <mx...@apache.org> wrote:
>>>
>>> > Thanks for noticing, Chiwan. I have the feeling this problem arose
>>> when the website was updated. The problem about linking documentation pages
>>> from the main website is that it is currently hard to go back to the main
>>> web site from the documentation (the nav and URL changes). However, now we
>>> are suffering from fragmentation.
>>> >
>>> > I would suggest to move the FAQ and How To Contribute to the Flink web
>>> site and delete them from the Flink repository.
>>>
>>> +1
>>
>>
>>
>

Re: Documentation Error

Posted by Stephan Ewen <se...@apache.org>.
+1
for moving the FAQ to the website.

On Tue, Jun 30, 2015 at 5:09 PM, Robert Metzger <rm...@apache.org> wrote:

> +1
> lets remove the FAQ from the source repo and put it on the website only.
>
> On Thu, Jun 25, 2015 at 3:14 PM, Ufuk Celebi <uc...@apache.org> wrote:
>
>>
>> On 25 Jun 2015, at 14:31, Maximilian Michels <mx...@apache.org> wrote:
>>
>> > Thanks for noticing, Chiwan. I have the feeling this problem arose when
>> the website was updated. The problem about linking documentation pages from
>> the main website is that it is currently hard to go back to the main web
>> site from the documentation (the nav and URL changes). However, now we are
>> suffering from fragmentation.
>> >
>> > I would suggest to move the FAQ and How To Contribute to the Flink web
>> site and delete them from the Flink repository.
>>
>> +1
>
>
>

Re: Documentation Error

Posted by Robert Metzger <rm...@apache.org>.
+1
lets remove the FAQ from the source repo and put it on the website only.

On Thu, Jun 25, 2015 at 3:14 PM, Ufuk Celebi <uc...@apache.org> wrote:

>
> On 25 Jun 2015, at 14:31, Maximilian Michels <mx...@apache.org> wrote:
>
> > Thanks for noticing, Chiwan. I have the feeling this problem arose when
> the website was updated. The problem about linking documentation pages from
> the main website is that it is currently hard to go back to the main web
> site from the documentation (the nav and URL changes). However, now we are
> suffering from fragmentation.
> >
> > I would suggest to move the FAQ and How To Contribute to the Flink web
> site and delete them from the Flink repository.
>
> +1

Re: Documentation Error

Posted by Ufuk Celebi <uc...@apache.org>.
On 25 Jun 2015, at 14:31, Maximilian Michels <mx...@apache.org> wrote:

> Thanks for noticing, Chiwan. I have the feeling this problem arose when the website was updated. The problem about linking documentation pages from the main website is that it is currently hard to go back to the main web site from the documentation (the nav and URL changes). However, now we are suffering from fragmentation. 
> 
> I would suggest to move the FAQ and How To Contribute to the Flink web site and delete them from the Flink repository.

+1

Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
Thanks for noticing, Chiwan. I have the feeling this problem arose when the
website was updated. The problem about linking documentation pages from the
main website is that it is currently hard to go back to the main web site
from the documentation (the nav and URL changes). However, now we are
suffering from fragmentation.

I would suggest to move the FAQ and How To Contribute to the Flink web site
and delete them from the Flink repository.

Cheers,
Max

On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org> wrote:

> How to contribute, and coding guidelines are also duplicated on the web
> site and the documentation.
> I think this duplication is not needed. We need to merge the duplication.
>
> Regards,
> Chiwan Park
>
> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org> wrote:
> >
> > Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
> realized the FAQ page is duplicated on the web site and the Flink
> documentation. So there is
> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
> http://flink.apache.org/faq.html
> >
> > I'm guessing somebody wanted a FAQ independent of the documentation
> version. However, I don't see how we will maintain multiple FAQs. The two
> have already diverged quite a bit and merging them is not trivial.
> >
> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
> > Another one: on
> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
> > in the "What is parallelism? How do I set it?" Section the links are
> broken.
> >
> > Cheers,
> > Max
> >
> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
> wrote:
> > Hi Max,
> >
> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
> >
> > Cheers,
> > Max
> >
> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
> > Hi Flinksters,
> >
> > just some minor:
> >
> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
> > in the second code sample should be
> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> > instead of:
> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> >
> > Cheers,
> > Max
> >
> >
> >
>
>
>
>
>

Re: Documentation Error

Posted by Maximilian Alber <al...@gmail.com>.
Hi Robert,

thanks for the offer. At the moment I'm to busy. But maybe when we begin to
use Flink for ML in the BBDC.

Cheers,
Max

On Thu, Jun 25, 2015 at 2:48 PM, Robert Metzger <rm...@apache.org> wrote:

> Hey Maximilian Alber,
> I don't know if you are interested in contributing in Flink, but if you
> would like to, these small fixes to the documentation are really helpful
> for us!
> Its actually quite easy to work with the documentation locally. It is
> located in the "docs/" directory of the Flink source.
> There is also a "build.sh" script, that will run a local webserver which
> is presenting the docs at localhost:4000.
> So you can read the Flink docs on your machine and make these small typo
> fixes as you spot them.
> In the end you commit the stuff to your github and open a pull request for
> us ;)
>
> On Thu, Jun 25, 2015 at 2:45 PM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
>
>> Another one: in the stream guide under "Connecting to the outside world"
>> "Sources" I guess one "by" should be a "be".
>>
>>
>> http://ci.apache.org/projects/flink/flink-docs-master/apis/streaming_guide.html
>>
>> On Thu, Jun 25, 2015 at 2:42 PM, Maximilian Michels <mx...@apache.org>
>> wrote:
>>
>>> Thanks Max. I think the documentation has grown a lot and needs an
>>> overhaul. We should remove the unnecessary non-Flink-related stuff (e.g.
>>> configuring ssh keys in the setup guide). I like your idea of having an
>>> "essential" guide that just covers the basics for people already familiar
>>> with other big data projects. It would be great if somebody could spare
>>> time to work on that.
>>>
>>> On Thu, Jun 25, 2015 at 2:31 PM, Maximilian Alber <
>>> alber.maximilian@gmail.com> wrote:
>>>
>>>> Something different. I just read through the Spark documentation and
>>>> yours. While the Spark one is quite unstructured and easy to understand,
>>>> yours is structured and really detailed. It's great that you have that in
>>>> depth documentation, but I would recommend you to make a boiled-down page
>>>> with just the basic stuff. Which would ease the life of beginners.
>>>>
>>>> Cheers,
>>>> Max
>>>>
>>>> On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org>
>>>> wrote:
>>>>
>>>>> How to contribute, and coding guidelines are also duplicated on the
>>>>> web site and the documentation.
>>>>> I think this duplication is not needed. We need to merge the
>>>>> duplication.
>>>>>
>>>>> Regards,
>>>>> Chiwan Park
>>>>>
>>>>> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org>
>>>>> wrote:
>>>>> >
>>>>> > Thanks. Fixed. Actually, that one is not linked anywhere, right?
>>>>> Just realized the FAQ page is duplicated on the web site and the Flink
>>>>> documentation. So there is
>>>>> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
>>>>> http://flink.apache.org/faq.html
>>>>> >
>>>>> > I'm guessing somebody wanted a FAQ independent of the documentation
>>>>> version. However, I don't see how we will maintain multiple FAQs. The two
>>>>> have already diverged quite a bit and merging them is not trivial.
>>>>> >
>>>>> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
>>>>> alber.maximilian@gmail.com> wrote:
>>>>> > Another one: on
>>>>> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
>>>>> > in the "What is parallelism? How do I set it?" Section the links are
>>>>> broken.
>>>>> >
>>>>> > Cheers,
>>>>> > Max
>>>>> >
>>>>> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
>>>>> wrote:
>>>>> > Hi Max,
>>>>> >
>>>>> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>>>>> >
>>>>> > Cheers,
>>>>> > Max
>>>>> >
>>>>> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
>>>>> alber.maximilian@gmail.com> wrote:
>>>>> > Hi Flinksters,
>>>>> >
>>>>> > just some minor:
>>>>> >
>>>>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>>>>> > in the second code sample should be
>>>>> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>>> > instead of:
>>>>> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>>> >
>>>>> > Cheers,
>>>>> > Max
>>>>> >
>>>>> >
>>>>> >
>>>>>
>>>>>
>>>>>
>>>>>
>>>>>
>>>>
>>>
>>
>

Re: Documentation Error

Posted by Robert Metzger <rm...@apache.org>.
Hey Maximilian Alber,
I don't know if you are interested in contributing in Flink, but if you
would like to, these small fixes to the documentation are really helpful
for us!
Its actually quite easy to work with the documentation locally. It is
located in the "docs/" directory of the Flink source.
There is also a "build.sh" script, that will run a local webserver which is
presenting the docs at localhost:4000.
So you can read the Flink docs on your machine and make these small typo
fixes as you spot them.
In the end you commit the stuff to your github and open a pull request for
us ;)

On Thu, Jun 25, 2015 at 2:45 PM, Maximilian Alber <
alber.maximilian@gmail.com> wrote:

> Another one: in the stream guide under "Connecting to the outside world"
> "Sources" I guess one "by" should be a "be".
>
>
> http://ci.apache.org/projects/flink/flink-docs-master/apis/streaming_guide.html
>
> On Thu, Jun 25, 2015 at 2:42 PM, Maximilian Michels <mx...@apache.org>
> wrote:
>
>> Thanks Max. I think the documentation has grown a lot and needs an
>> overhaul. We should remove the unnecessary non-Flink-related stuff (e.g.
>> configuring ssh keys in the setup guide). I like your idea of having an
>> "essential" guide that just covers the basics for people already familiar
>> with other big data projects. It would be great if somebody could spare
>> time to work on that.
>>
>> On Thu, Jun 25, 2015 at 2:31 PM, Maximilian Alber <
>> alber.maximilian@gmail.com> wrote:
>>
>>> Something different. I just read through the Spark documentation and
>>> yours. While the Spark one is quite unstructured and easy to understand,
>>> yours is structured and really detailed. It's great that you have that in
>>> depth documentation, but I would recommend you to make a boiled-down page
>>> with just the basic stuff. Which would ease the life of beginners.
>>>
>>> Cheers,
>>> Max
>>>
>>> On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org>
>>> wrote:
>>>
>>>> How to contribute, and coding guidelines are also duplicated on the web
>>>> site and the documentation.
>>>> I think this duplication is not needed. We need to merge the
>>>> duplication.
>>>>
>>>> Regards,
>>>> Chiwan Park
>>>>
>>>> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org>
>>>> wrote:
>>>> >
>>>> > Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
>>>> realized the FAQ page is duplicated on the web site and the Flink
>>>> documentation. So there is
>>>> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
>>>> http://flink.apache.org/faq.html
>>>> >
>>>> > I'm guessing somebody wanted a FAQ independent of the documentation
>>>> version. However, I don't see how we will maintain multiple FAQs. The two
>>>> have already diverged quite a bit and merging them is not trivial.
>>>> >
>>>> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
>>>> alber.maximilian@gmail.com> wrote:
>>>> > Another one: on
>>>> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
>>>> > in the "What is parallelism? How do I set it?" Section the links are
>>>> broken.
>>>> >
>>>> > Cheers,
>>>> > Max
>>>> >
>>>> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
>>>> wrote:
>>>> > Hi Max,
>>>> >
>>>> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>>>> >
>>>> > Cheers,
>>>> > Max
>>>> >
>>>> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
>>>> alber.maximilian@gmail.com> wrote:
>>>> > Hi Flinksters,
>>>> >
>>>> > just some minor:
>>>> >
>>>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>>>> > in the second code sample should be
>>>> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>> > instead of:
>>>> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>> >
>>>> > Cheers,
>>>> > Max
>>>> >
>>>> >
>>>> >
>>>>
>>>>
>>>>
>>>>
>>>>
>>>
>>
>

Re: Documentation Error

Posted by Maximilian Alber <al...@gmail.com>.
Another one: in the stream guide under "Connecting to the outside world"
"Sources" I guess one "by" should be a "be".

http://ci.apache.org/projects/flink/flink-docs-master/apis/streaming_guide.html

On Thu, Jun 25, 2015 at 2:42 PM, Maximilian Michels <mx...@apache.org> wrote:

> Thanks Max. I think the documentation has grown a lot and needs an
> overhaul. We should remove the unnecessary non-Flink-related stuff (e.g.
> configuring ssh keys in the setup guide). I like your idea of having an
> "essential" guide that just covers the basics for people already familiar
> with other big data projects. It would be great if somebody could spare
> time to work on that.
>
> On Thu, Jun 25, 2015 at 2:31 PM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
>
>> Something different. I just read through the Spark documentation and
>> yours. While the Spark one is quite unstructured and easy to understand,
>> yours is structured and really detailed. It's great that you have that in
>> depth documentation, but I would recommend you to make a boiled-down page
>> with just the basic stuff. Which would ease the life of beginners.
>>
>> Cheers,
>> Max
>>
>> On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org>
>> wrote:
>>
>>> How to contribute, and coding guidelines are also duplicated on the web
>>> site and the documentation.
>>> I think this duplication is not needed. We need to merge the duplication.
>>>
>>> Regards,
>>> Chiwan Park
>>>
>>> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org>
>>> wrote:
>>> >
>>> > Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
>>> realized the FAQ page is duplicated on the web site and the Flink
>>> documentation. So there is
>>> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
>>> http://flink.apache.org/faq.html
>>> >
>>> > I'm guessing somebody wanted a FAQ independent of the documentation
>>> version. However, I don't see how we will maintain multiple FAQs. The two
>>> have already diverged quite a bit and merging them is not trivial.
>>> >
>>> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
>>> alber.maximilian@gmail.com> wrote:
>>> > Another one: on
>>> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
>>> > in the "What is parallelism? How do I set it?" Section the links are
>>> broken.
>>> >
>>> > Cheers,
>>> > Max
>>> >
>>> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
>>> wrote:
>>> > Hi Max,
>>> >
>>> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>>> >
>>> > Cheers,
>>> > Max
>>> >
>>> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
>>> alber.maximilian@gmail.com> wrote:
>>> > Hi Flinksters,
>>> >
>>> > just some minor:
>>> >
>>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>>> > in the second code sample should be
>>> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>> > instead of:
>>> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>> >
>>> > Cheers,
>>> > Max
>>> >
>>> >
>>> >
>>>
>>>
>>>
>>>
>>>
>>
>

Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
Thanks Max. I think the documentation has grown a lot and needs an
overhaul. We should remove the unnecessary non-Flink-related stuff (e.g.
configuring ssh keys in the setup guide). I like your idea of having an
"essential" guide that just covers the basics for people already familiar
with other big data projects. It would be great if somebody could spare
time to work on that.

On Thu, Jun 25, 2015 at 2:31 PM, Maximilian Alber <
alber.maximilian@gmail.com> wrote:

> Something different. I just read through the Spark documentation and
> yours. While the Spark one is quite unstructured and easy to understand,
> yours is structured and really detailed. It's great that you have that in
> depth documentation, but I would recommend you to make a boiled-down page
> with just the basic stuff. Which would ease the life of beginners.
>
> Cheers,
> Max
>
> On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org>
> wrote:
>
>> How to contribute, and coding guidelines are also duplicated on the web
>> site and the documentation.
>> I think this duplication is not needed. We need to merge the duplication.
>>
>> Regards,
>> Chiwan Park
>>
>> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org> wrote:
>> >
>> > Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
>> realized the FAQ page is duplicated on the web site and the Flink
>> documentation. So there is
>> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
>> http://flink.apache.org/faq.html
>> >
>> > I'm guessing somebody wanted a FAQ independent of the documentation
>> version. However, I don't see how we will maintain multiple FAQs. The two
>> have already diverged quite a bit and merging them is not trivial.
>> >
>> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
>> alber.maximilian@gmail.com> wrote:
>> > Another one: on
>> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
>> > in the "What is parallelism? How do I set it?" Section the links are
>> broken.
>> >
>> > Cheers,
>> > Max
>> >
>> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
>> wrote:
>> > Hi Max,
>> >
>> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>> >
>> > Cheers,
>> > Max
>> >
>> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
>> alber.maximilian@gmail.com> wrote:
>> > Hi Flinksters,
>> >
>> > just some minor:
>> >
>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>> > in the second code sample should be
>> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>> > instead of:
>> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
>> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>> >
>> > Cheers,
>> > Max
>> >
>> >
>> >
>>
>>
>>
>>
>>
>

Re: Documentation Error

Posted by Maximilian Alber <al...@gmail.com>.
Something different. I just read through the Spark documentation and yours.
While the Spark one is quite unstructured and easy to understand, yours is
structured and really detailed. It's great that you have that in depth
documentation, but I would recommend you to make a boiled-down page with
just the basic stuff. Which would ease the life of beginners.

Cheers,
Max

On Thu, Jun 25, 2015 at 2:20 PM, Chiwan Park <ch...@apache.org> wrote:

> How to contribute, and coding guidelines are also duplicated on the web
> site and the documentation.
> I think this duplication is not needed. We need to merge the duplication.
>
> Regards,
> Chiwan Park
>
> > On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org> wrote:
> >
> > Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
> realized the FAQ page is duplicated on the web site and the Flink
> documentation. So there is
> http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
> http://flink.apache.org/faq.html
> >
> > I'm guessing somebody wanted a FAQ independent of the documentation
> version. However, I don't see how we will maintain multiple FAQs. The two
> have already diverged quite a bit and merging them is not trivial.
> >
> > On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
> > Another one: on
> > http://ci.apache.org/projects/flink/flink-docs-master/faq.html
> > in the "What is parallelism? How do I set it?" Section the links are
> broken.
> >
> > Cheers,
> > Max
> >
> > On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
> wrote:
> > Hi Max,
> >
> > Thanks for noticing! Fixed on the master and for the 0.9.1 release.
> >
> > Cheers,
> > Max
> >
> > On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
> > Hi Flinksters,
> >
> > just some minor:
> >
> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
> > in the second code sample should be
> > ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> > instead of:
> > ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096
> ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> >
> > Cheers,
> > Max
> >
> >
> >
>
>
>
>
>

Re: Documentation Error

Posted by Chiwan Park <ch...@apache.org>.
How to contribute, and coding guidelines are also duplicated on the web site and the documentation.
I think this duplication is not needed. We need to merge the duplication.

Regards,
Chiwan Park

> On Jun 25, 2015, at 9:01 PM, Maximilian Michels <mx...@apache.org> wrote:
> 
> Thanks. Fixed. Actually, that one is not linked anywhere, right? Just realized the FAQ page is duplicated on the web site and the Flink documentation. So there is http://ci.apache.org/projects/flink/flink-docs-master/faq.html and http://flink.apache.org/faq.html
> 
> I'm guessing somebody wanted a FAQ independent of the documentation version. However, I don't see how we will maintain multiple FAQs. The two have already diverged quite a bit and merging them is not trivial.
> 
> On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <al...@gmail.com> wrote:
> Another one: on
> http://ci.apache.org/projects/flink/flink-docs-master/faq.html
> in the "What is parallelism? How do I set it?" Section the links are broken.
> 
> Cheers,
> Max
> 
> On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org> wrote:
> Hi Max,
> 
> Thanks for noticing! Fixed on the master and for the 0.9.1 release.
> 
> Cheers,
> Max
> 
> On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <al...@gmail.com> wrote:
> Hi Flinksters,
> 
> just some minor:
> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
> in the second code sample should be
> ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> instead of:
> ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
> 
> Cheers,
> Max
> 
> 
> 





Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
Thanks. Fixed. Actually, that one is not linked anywhere, right? Just
realized the FAQ page is duplicated on the web site and the Flink
documentation. So there is
http://ci.apache.org/projects/flink/flink-docs-master/faq.html and
http://flink.apache.org/faq.html

I'm guessing somebody wanted a FAQ independent of the documentation
version. However, I don't see how we will maintain multiple FAQs. The two
have already diverged quite a bit and merging them is not trivial.

On Thu, Jun 25, 2015 at 11:40 AM, Maximilian Alber <
alber.maximilian@gmail.com> wrote:

> Another one: on
> http://ci.apache.org/projects/flink/flink-docs-master/faq.html
> in the "What is parallelism? How do I set it?" Section the links are
> broken.
>
> Cheers,
> Max
>
> On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org>
> wrote:
>
>> Hi Max,
>>
>> Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>>
>> Cheers,
>> Max
>>
>> On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
>> alber.maximilian@gmail.com> wrote:
>>
>>> Hi Flinksters,
>>>
>>> just some minor:
>>>
>>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>>> in the second code sample should be
>>>
>>> ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>
>>> instead of:
>>>
>>> ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>>
>>>
>>> Cheers,
>>> Max
>>>
>>
>>
>

Re: Documentation Error

Posted by Maximilian Alber <al...@gmail.com>.
Another one: on
http://ci.apache.org/projects/flink/flink-docs-master/faq.html
in the "What is parallelism? How do I set it?" Section the links are broken.

Cheers,
Max

On Wed, Jun 24, 2015 at 9:52 AM, Maximilian Michels <mx...@apache.org> wrote:

> Hi Max,
>
> Thanks for noticing! Fixed on the master and for the 0.9.1 release.
>
> Cheers,
> Max
>
> On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
> alber.maximilian@gmail.com> wrote:
>
>> Hi Flinksters,
>>
>> just some minor:
>>
>> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
>> in the second code sample should be
>>
>> ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>
>> instead of:
>>
>> ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>>
>>
>> Cheers,
>> Max
>>
>
>

Re: Documentation Error

Posted by Maximilian Michels <mx...@apache.org>.
Hi Max,

Thanks for noticing! Fixed on the master and for the 0.9.1 release.

Cheers,
Max

On Tue, Jun 23, 2015 at 5:09 PM, Maximilian Alber <
alber.maximilian@gmail.com> wrote:

> Hi Flinksters,
>
> just some minor:
> http://ci.apache.org/projects/flink/flink-docs-master/setup/yarn_setup.html
> in the second code sample should be
>
> ./bin/flink run -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>
> instead of:
>
> ./bin/flink -m yarn-cluster -yn 4 -yjm 1024 -ytm 4096 ./examples/flink-java-examples-0.9-SNAPSHOT-WordCount.jar
>
>
> Cheers,
> Max
>