You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@beam.apache.org by Ismaël Mejía <ie...@gmail.com> on 2016/05/20 07:24:43 UTC
[PROPOSAL] Beam FAQ
Hello,
I have stumbled with some issues while trying to execute pipelines with all
the
different runners and I was wondering if we need to create a Frequently
Asked
Questions (FAQ) section on the website. Maybe it would be better to create
such
thing as a wiki so we can contribute faster.
What do you think ? And what way you think is the better to do so (infra) ?
Regards,
Ismaël
Re: [PROPOSAL] Beam FAQ
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
+1
Regards
JB
On 06/16/2016 09:41 PM, James Malone wrote:
> On Thu, Jun 16, 2016 at 12:37 PM, Ismal Meja <ie...@gmail.com> wrote:
>
>>
>> 1. Maybe it is a good idea to put the documentation in an iframe so the
>> site navigation don't get lost.
>> 2. Can we create a reference link to the latest version of the
>> documentation ? Something like
>> https://beam.apache.org/javadoc/latest/
>> This is easier to refer to the latest version of the doc and it is a common
>> practice in other projects.
>>
>
> These are both awesome ideas and they should be (I propose) part of the
> Beam site redesign. :)
>
--
Jean-Baptiste Onofr
jbonofre@apache.org
http://blog.nanthrax.net
Talend - http://www.talend.com
Re: [PROPOSAL] Beam FAQ
Posted by James Malone <ja...@google.com.INVALID>.
On Thu, Jun 16, 2016 at 12:37 PM, Ismaël Mejía <ie...@gmail.com> wrote:
>
> 1. Maybe it is a good idea to put the documentation in an iframe so the
> site navigation don't get lost.
> 2. Can we create a reference link to the latest version of the
> documentation ? Something like
> https://beam.apache.org/javadoc/latest/
> This is easier to refer to the latest version of the doc and it is a common
> practice in other projects.
>
These are both awesome ideas and they should be (I propose) part of the
Beam site redesign. :)
Re: [PROPOSAL] Beam FAQ
Posted by Ismaël Mejía <ie...@gmail.com>.
Hello, just for reference, in another thread it was mentioned that the Beam
FAQ idea already had a JIRA.
https://issues.apache.org/jira/browse/BEAM-161
I just saw that the javadoc is now online. Excellent ! You can find it in
the menu:
Technical Documentation -> API Reference
https://beam.apache.org/javadoc/0.1.0-incubating/
Davor (or the others), just two ideas:
1. Maybe it is a good idea to put the documentation in an iframe so the
site navigation don't get lost.
2. Can we create a reference link to the latest version of the
documentation ? Something like
https://beam.apache.org/javadoc/latest/
This is easier to refer to the latest version of the doc and it is a common
practice in other projects.
Regards,
Ismael
On Wed, Jun 1, 2016 at 2:16 AM, Davor Bonaci <da...@google.com.invalid>
wrote:
> Javadoc publication should be a part of every release. As soon as the first
> release is complete, Javadoc will be on our website.
>
> On Sun, May 29, 2016 at 10:35 PM, Jean-Baptiste Onofré <jb...@nanthrax.net>
> wrote:
>
> > Thanks Devin,
> >
> > gonna take a look !
> >
> > Regards
> > JB
> >
> >
> > On 05/28/2016 02:20 AM, Devin Donnelly wrote:
> >
> >> The relevant file you're looking for, and the one that's constantly
> >> updated, is:
> >>
> >> /docs/programming-guide.md
> >>
> >> On Fri, May 27, 2016 at 5:20 PM, Devin Donnelly <dd...@google.com>
> >> wrote:
> >>
> >> Here's the URL of my fork, so you can see what it looks like so far:
> >>>
> >>> https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
> >>>
> >>> On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofré <jb@nanthrax.net
> >
> >>> wrote:
> >>>
> >>> Agree, it would be great to have such user guide + a started guide for
> >>>> Beam.
> >>>>
> >>>> Regards
> >>>> JB
> >>>>
> >>>>
> >>>> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
> >>>>
> >>>> I think Josh's Crunch User Guide is a great example of what a user
> guide
> >>>>> should cover. https://crunch.apache.org/user-guide.html
> >>>>>
> >>>>> On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com>
> >>>>> wrote:
> >>>>>
> >>>>> Ok, I agree Davor for end users a getting started guide is not only
> >>>>>
> >>>>>> important but I would say critical at this moment, the FAQ can be an
> >>>>>> effort
> >>>>>> run in parallel. The project is incubating so the FAQ would be in
> its
> >>>>>> early
> >>>>>> state, and ideally we must not need an enormous FAQ, however this
> >>>>>> project
> >>>>>> mixes many different technologies, and I can easily imagine frequent
> >>>>>> questions about technical details on Sources, Sinks, and Runners
> e.g.
> >>>>>> my
> >>>>>> question on how to reuse the context on the spark runner is a good
> >>>>>> example,
> >>>>>> it is not general enough to put it as a default in the runner, it is
> >>>>>> not
> >>>>>> simple enough for a getting started guide, but a good amount of
> users
> >>>>>> will
> >>>>>> have to deal with it once they write tests for their pipelines.
> >>>>>>
> >>>>>> Devin, thanks for writing, I am interested in the draft, can you
> >>>>>> please
> >>>>>> share the URL of your fork, so other people can eventually take a
> >>>>>> look/contribute.
> >>>>>>
> >>>>>> Ismael
> >>>>>>
> >>>>>>
> >>>>>>
> >>>>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
> >>>>>> ddonnelly@google.com.invalid> wrote:
> >>>>>>
> >>>>>> FYI: User documentation draft (the Beam Programming Guide) is well
> >>>>>>
> >>>>>>> underway. I'm regularly pushing stuff out to a fork of the Beam
> >>>>>>> website
> >>>>>>> repo if anyone wants a sneak peek.
> >>>>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
> >>>>>>>
> >>>>>>> wrote:
> >>>>>>
> >>>>>>
> >>>>>>> We are missing a basic getting started guide along with the rest of
> >>>>>>>
> >>>>>>>>
> >>>>>>>> user
> >>>>>>>
> >>>>>>
> >>>>>> documentation. I think we should work on this first.
> >>>>>>>
> >>>>>>>>
> >>>>>>>> FAQ is a great idea for things that aren't or cannot be covered by
> >>>>>>>>
> >>>>>>>> those
> >>>>>>>
> >>>>>>
> >>>>>> documents -- but, we cannot really start that before we have at
> least
> >>>>>>> a
> >>>>>>>
> >>>>>>>> draft version of the previous.
> >>>>>>>>
> >>>>>>>> Wiki hosting would be owned by Infra, if we choose to go down that
> >>>>>>>> path
> >>>>>>>>
> >>>>>>>> at
> >>>>>>>
> >>>>>>> some point.
> >>>>>>>>
> >>>>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <
> >>>>>>>> jb@nanthrax.net
> >>>>>>>>
> >>>>>>>>
> >>>>>>> wrote:
> >>>>>>>
> >>>>>>>>
> >>>>>>>> Hi,
> >>>>>>>>
> >>>>>>>>>
> >>>>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer
> kind
> >>>>>>>>> of
> >>>>>>>>> governance and review using the website.
> >>>>>>>>>
> >>>>>>>>> Regards
> >>>>>>>>> JB
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
> >>>>>>>>>
> >>>>>>>>> Hello,
> >>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>> I have stumbled with some issues while trying to execute
> pipelines
> >>>>>>>>>>
> >>>>>>>>>> with
> >>>>>>>>>
> >>>>>>>>
> >>>>>>> all
> >>>>>>>>
> >>>>>>>>> the
> >>>>>>>>>> different runners and I was wondering if we need to create a
> >>>>>>>>>>
> >>>>>>>>>> Frequently
> >>>>>>>>>
> >>>>>>>>
> >>>>>>> Asked
> >>>>>>>>
> >>>>>>>>> Questions (FAQ) section on the website. Maybe it would be better
> to
> >>>>>>>>>>
> >>>>>>>>>> create
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>> such
> >>>>>>>>>
> >>>>>>>>>> thing as a wiki so we can contribute faster.
> >>>>>>>>>>
> >>>>>>>>>> What do you think ? And what way you think is the better to do
> so
> >>>>>>>>>>
> >>>>>>>>>> (infra)
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>> ?
> >>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>> Regards,
> >>>>>>>>>> Ismaël
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>> --
> >>>>>>>>>>
> >>>>>>>>> Jean-Baptiste Onofré
> >>>>>>>>> jbonofre@apache.org
> >>>>>>>>> http://blog.nanthrax.net
> >>>>>>>>> Talend - http://www.talend.com
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>
> >>>>>>
> >>>>> --
> >>>> Jean-Baptiste Onofré
> >>>> jbonofre@apache.org
> >>>> http://blog.nanthrax.net
> >>>> Talend - http://www.talend.com
> >>>>
> >>>>
> >>>
> >>>
> >>
> > --
> > Jean-Baptiste Onofré
> > jbonofre@apache.org
> > http://blog.nanthrax.net
> > Talend - http://www.talend.com
> >
>
Re: [PROPOSAL] Beam FAQ
Posted by Davor Bonaci <da...@google.com.INVALID>.
Javadoc publication should be a part of every release. As soon as the first
release is complete, Javadoc will be on our website.
On Sun, May 29, 2016 at 10:35 PM, Jean-Baptiste Onofré <jb...@nanthrax.net>
wrote:
> Thanks Devin,
>
> gonna take a look !
>
> Regards
> JB
>
>
> On 05/28/2016 02:20 AM, Devin Donnelly wrote:
>
>> The relevant file you're looking for, and the one that's constantly
>> updated, is:
>>
>> /docs/programming-guide.md
>>
>> On Fri, May 27, 2016 at 5:20 PM, Devin Donnelly <dd...@google.com>
>> wrote:
>>
>> Here's the URL of my fork, so you can see what it looks like so far:
>>>
>>> https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
>>>
>>> On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
>>> wrote:
>>>
>>> Agree, it would be great to have such user guide + a started guide for
>>>> Beam.
>>>>
>>>> Regards
>>>> JB
>>>>
>>>>
>>>> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
>>>>
>>>> I think Josh's Crunch User Guide is a great example of what a user guide
>>>>> should cover. https://crunch.apache.org/user-guide.html
>>>>>
>>>>> On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com>
>>>>> wrote:
>>>>>
>>>>> Ok, I agree Davor for end users a getting started guide is not only
>>>>>
>>>>>> important but I would say critical at this moment, the FAQ can be an
>>>>>> effort
>>>>>> run in parallel. The project is incubating so the FAQ would be in its
>>>>>> early
>>>>>> state, and ideally we must not need an enormous FAQ, however this
>>>>>> project
>>>>>> mixes many different technologies, and I can easily imagine frequent
>>>>>> questions about technical details on Sources, Sinks, and Runners e.g.
>>>>>> my
>>>>>> question on how to reuse the context on the spark runner is a good
>>>>>> example,
>>>>>> it is not general enough to put it as a default in the runner, it is
>>>>>> not
>>>>>> simple enough for a getting started guide, but a good amount of users
>>>>>> will
>>>>>> have to deal with it once they write tests for their pipelines.
>>>>>>
>>>>>> Devin, thanks for writing, I am interested in the draft, can you
>>>>>> please
>>>>>> share the URL of your fork, so other people can eventually take a
>>>>>> look/contribute.
>>>>>>
>>>>>> Ismael
>>>>>>
>>>>>>
>>>>>>
>>>>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
>>>>>> ddonnelly@google.com.invalid> wrote:
>>>>>>
>>>>>> FYI: User documentation draft (the Beam Programming Guide) is well
>>>>>>
>>>>>>> underway. I'm regularly pushing stuff out to a fork of the Beam
>>>>>>> website
>>>>>>> repo if anyone wants a sneak peek.
>>>>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
>>>>>>>
>>>>>>> wrote:
>>>>>>
>>>>>>
>>>>>>> We are missing a basic getting started guide along with the rest of
>>>>>>>
>>>>>>>>
>>>>>>>> user
>>>>>>>
>>>>>>
>>>>>> documentation. I think we should work on this first.
>>>>>>>
>>>>>>>>
>>>>>>>> FAQ is a great idea for things that aren't or cannot be covered by
>>>>>>>>
>>>>>>>> those
>>>>>>>
>>>>>>
>>>>>> documents -- but, we cannot really start that before we have at least
>>>>>>> a
>>>>>>>
>>>>>>>> draft version of the previous.
>>>>>>>>
>>>>>>>> Wiki hosting would be owned by Infra, if we choose to go down that
>>>>>>>> path
>>>>>>>>
>>>>>>>> at
>>>>>>>
>>>>>>> some point.
>>>>>>>>
>>>>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <
>>>>>>>> jb@nanthrax.net
>>>>>>>>
>>>>>>>>
>>>>>>> wrote:
>>>>>>>
>>>>>>>>
>>>>>>>> Hi,
>>>>>>>>
>>>>>>>>>
>>>>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind
>>>>>>>>> of
>>>>>>>>> governance and review using the website.
>>>>>>>>>
>>>>>>>>> Regards
>>>>>>>>> JB
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
>>>>>>>>>
>>>>>>>>> Hello,
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> I have stumbled with some issues while trying to execute pipelines
>>>>>>>>>>
>>>>>>>>>> with
>>>>>>>>>
>>>>>>>>
>>>>>>> all
>>>>>>>>
>>>>>>>>> the
>>>>>>>>>> different runners and I was wondering if we need to create a
>>>>>>>>>>
>>>>>>>>>> Frequently
>>>>>>>>>
>>>>>>>>
>>>>>>> Asked
>>>>>>>>
>>>>>>>>> Questions (FAQ) section on the website. Maybe it would be better to
>>>>>>>>>>
>>>>>>>>>> create
>>>>>>>>>
>>>>>>>>
>>>>>>>> such
>>>>>>>>>
>>>>>>>>>> thing as a wiki so we can contribute faster.
>>>>>>>>>>
>>>>>>>>>> What do you think ? And what way you think is the better to do so
>>>>>>>>>>
>>>>>>>>>> (infra)
>>>>>>>>>
>>>>>>>>
>>>>>>>> ?
>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> Regards,
>>>>>>>>>> Ismaël
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> --
>>>>>>>>>>
>>>>>>>>> Jean-Baptiste Onofré
>>>>>>>>> jbonofre@apache.org
>>>>>>>>> http://blog.nanthrax.net
>>>>>>>>> Talend - http://www.talend.com
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>> --
>>>> Jean-Baptiste Onofré
>>>> jbonofre@apache.org
>>>> http://blog.nanthrax.net
>>>> Talend - http://www.talend.com
>>>>
>>>>
>>>
>>>
>>
> --
> Jean-Baptiste Onofré
> jbonofre@apache.org
> http://blog.nanthrax.net
> Talend - http://www.talend.com
>
Re: [PROPOSAL] Beam FAQ
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Thanks Devin,
gonna take a look !
Regards
JB
On 05/28/2016 02:20 AM, Devin Donnelly wrote:
> The relevant file you're looking for, and the one that's constantly
> updated, is:
>
> /docs/programming-guide.md
>
> On Fri, May 27, 2016 at 5:20 PM, Devin Donnelly <dd...@google.com>
> wrote:
>
>> Here's the URL of my fork, so you can see what it looks like so far:
>>
>> https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
>>
>> On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofr� <jb...@nanthrax.net>
>> wrote:
>>
>>> Agree, it would be great to have such user guide + a started guide for
>>> Beam.
>>>
>>> Regards
>>> JB
>>>
>>>
>>> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
>>>
>>>> I think Josh's Crunch User Guide is a great example of what a user guide
>>>> should cover. https://crunch.apache.org/user-guide.html
>>>>
>>>> On Mon, May 23, 2016 at 2:00 AM Isma�l Mej�a <ie...@gmail.com> wrote:
>>>>
>>>> Ok, I agree Davor for end users a getting started guide is not only
>>>>> important but I would say critical at this moment, the FAQ can be an
>>>>> effort
>>>>> run in parallel. The project is incubating so the FAQ would be in its
>>>>> early
>>>>> state, and ideally we must not need an enormous FAQ, however this
>>>>> project
>>>>> mixes many different technologies, and I can easily imagine frequent
>>>>> questions about technical details on Sources, Sinks, and Runners e.g. my
>>>>> question on how to reuse the context on the spark runner is a good
>>>>> example,
>>>>> it is not general enough to put it as a default in the runner, it is not
>>>>> simple enough for a getting started guide, but a good amount of users
>>>>> will
>>>>> have to deal with it once they write tests for their pipelines.
>>>>>
>>>>> Devin, thanks for writing, I am interested in the draft, can you please
>>>>> share the URL of your fork, so other people can eventually take a
>>>>> look/contribute.
>>>>>
>>>>> Ismael
>>>>>
>>>>>
>>>>>
>>>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
>>>>> ddonnelly@google.com.invalid> wrote:
>>>>>
>>>>> FYI: User documentation draft (the Beam Programming Guide) is well
>>>>>> underway. I'm regularly pushing stuff out to a fork of the Beam website
>>>>>> repo if anyone wants a sneak peek.
>>>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
>>>>>>
>>>>> wrote:
>>>>>
>>>>>>
>>>>>> We are missing a basic getting started guide along with the rest of
>>>>>>>
>>>>>> user
>>>>>
>>>>>> documentation. I think we should work on this first.
>>>>>>>
>>>>>>> FAQ is a great idea for things that aren't or cannot be covered by
>>>>>>>
>>>>>> those
>>>>>
>>>>>> documents -- but, we cannot really start that before we have at least a
>>>>>>> draft version of the previous.
>>>>>>>
>>>>>>> Wiki hosting would be owned by Infra, if we choose to go down that
>>>>>>> path
>>>>>>>
>>>>>> at
>>>>>>
>>>>>>> some point.
>>>>>>>
>>>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofr� <
>>>>>>> jb@nanthrax.net
>>>>>>>
>>>>>>
>>>>>> wrote:
>>>>>>>
>>>>>>> Hi,
>>>>>>>>
>>>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind of
>>>>>>>> governance and review using the website.
>>>>>>>>
>>>>>>>> Regards
>>>>>>>> JB
>>>>>>>>
>>>>>>>>
>>>>>>>> On 05/20/2016 09:24 AM, Isma�l Mej�a wrote:
>>>>>>>>
>>>>>>>> Hello,
>>>>>>>>>
>>>>>>>>> I have stumbled with some issues while trying to execute pipelines
>>>>>>>>>
>>>>>>>> with
>>>>>>
>>>>>>> all
>>>>>>>>> the
>>>>>>>>> different runners and I was wondering if we need to create a
>>>>>>>>>
>>>>>>>> Frequently
>>>>>>
>>>>>>> Asked
>>>>>>>>> Questions (FAQ) section on the website. Maybe it would be better to
>>>>>>>>>
>>>>>>>> create
>>>>>>>
>>>>>>>> such
>>>>>>>>> thing as a wiki so we can contribute faster.
>>>>>>>>>
>>>>>>>>> What do you think ? And what way you think is the better to do so
>>>>>>>>>
>>>>>>>> (infra)
>>>>>>>
>>>>>>>> ?
>>>>>>>>>
>>>>>>>>> Regards,
>>>>>>>>> Isma�l
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> --
>>>>>>>> Jean-Baptiste Onofr�
>>>>>>>> jbonofre@apache.org
>>>>>>>> http://blog.nanthrax.net
>>>>>>>> Talend - http://www.talend.com
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>> --
>>> Jean-Baptiste Onofr�
>>> jbonofre@apache.org
>>> http://blog.nanthrax.net
>>> Talend - http://www.talend.com
>>>
>>
>>
>
--
Jean-Baptiste Onofr�
jbonofre@apache.org
http://blog.nanthrax.net
Talend - http://www.talend.com
Re: [PROPOSAL] Beam FAQ
Posted by Ismaël Mejía <ie...@gmail.com>.
Thanks Devin I will take a look.
Another missing documentation we need (and I suppose it will come with the
first release) is a website for the current SDK javadoc. Are the javadocs
already published in some public place (beam.apache.org or people.apache,
etc.) ? or what is the current plan ?
On Sat, May 28, 2016 at 2:20 AM, Devin Donnelly <
ddonnelly@google.com.invalid> wrote:
> The relevant file you're looking for, and the one that's constantly
> updated, is:
>
> /docs/programming-guide.md
>
> On Fri, May 27, 2016 at 5:20 PM, Devin Donnelly <dd...@google.com>
> wrote:
>
> > Here's the URL of my fork, so you can see what it looks like so far:
> >
> > https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
> >
> > On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
> > wrote:
> >
> >> Agree, it would be great to have such user guide + a started guide for
> >> Beam.
> >>
> >> Regards
> >> JB
> >>
> >>
> >> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
> >>
> >>> I think Josh's Crunch User Guide is a great example of what a user
> guide
> >>> should cover. https://crunch.apache.org/user-guide.html
> >>>
> >>> On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com>
> wrote:
> >>>
> >>> Ok, I agree Davor for end users a getting started guide is not only
> >>>> important but I would say critical at this moment, the FAQ can be an
> >>>> effort
> >>>> run in parallel. The project is incubating so the FAQ would be in its
> >>>> early
> >>>> state, and ideally we must not need an enormous FAQ, however this
> >>>> project
> >>>> mixes many different technologies, and I can easily imagine frequent
> >>>> questions about technical details on Sources, Sinks, and Runners e.g.
> my
> >>>> question on how to reuse the context on the spark runner is a good
> >>>> example,
> >>>> it is not general enough to put it as a default in the runner, it is
> not
> >>>> simple enough for a getting started guide, but a good amount of users
> >>>> will
> >>>> have to deal with it once they write tests for their pipelines.
> >>>>
> >>>> Devin, thanks for writing, I am interested in the draft, can you
> please
> >>>> share the URL of your fork, so other people can eventually take a
> >>>> look/contribute.
> >>>>
> >>>> Ismael
> >>>>
> >>>>
> >>>>
> >>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
> >>>> ddonnelly@google.com.invalid> wrote:
> >>>>
> >>>> FYI: User documentation draft (the Beam Programming Guide) is well
> >>>>> underway. I'm regularly pushing stuff out to a fork of the Beam
> website
> >>>>> repo if anyone wants a sneak peek.
> >>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
> >>>>>
> >>>> wrote:
> >>>>
> >>>>>
> >>>>> We are missing a basic getting started guide along with the rest of
> >>>>>>
> >>>>> user
> >>>>
> >>>>> documentation. I think we should work on this first.
> >>>>>>
> >>>>>> FAQ is a great idea for things that aren't or cannot be covered by
> >>>>>>
> >>>>> those
> >>>>
> >>>>> documents -- but, we cannot really start that before we have at
> least a
> >>>>>> draft version of the previous.
> >>>>>>
> >>>>>> Wiki hosting would be owned by Infra, if we choose to go down that
> >>>>>> path
> >>>>>>
> >>>>> at
> >>>>>
> >>>>>> some point.
> >>>>>>
> >>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <
> >>>>>> jb@nanthrax.net
> >>>>>>
> >>>>>
> >>>>> wrote:
> >>>>>>
> >>>>>> Hi,
> >>>>>>>
> >>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind
> of
> >>>>>>> governance and review using the website.
> >>>>>>>
> >>>>>>> Regards
> >>>>>>> JB
> >>>>>>>
> >>>>>>>
> >>>>>>> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
> >>>>>>>
> >>>>>>> Hello,
> >>>>>>>>
> >>>>>>>> I have stumbled with some issues while trying to execute pipelines
> >>>>>>>>
> >>>>>>> with
> >>>>>
> >>>>>> all
> >>>>>>>> the
> >>>>>>>> different runners and I was wondering if we need to create a
> >>>>>>>>
> >>>>>>> Frequently
> >>>>>
> >>>>>> Asked
> >>>>>>>> Questions (FAQ) section on the website. Maybe it would be better
> to
> >>>>>>>>
> >>>>>>> create
> >>>>>>
> >>>>>>> such
> >>>>>>>> thing as a wiki so we can contribute faster.
> >>>>>>>>
> >>>>>>>> What do you think ? And what way you think is the better to do so
> >>>>>>>>
> >>>>>>> (infra)
> >>>>>>
> >>>>>>> ?
> >>>>>>>>
> >>>>>>>> Regards,
> >>>>>>>> Ismaël
> >>>>>>>>
> >>>>>>>>
> >>>>>>>> --
> >>>>>>> Jean-Baptiste Onofré
> >>>>>>> jbonofre@apache.org
> >>>>>>> http://blog.nanthrax.net
> >>>>>>> Talend - http://www.talend.com
> >>>>>>>
> >>>>>>>
> >>>>>>
> >>>>>
> >>>>
> >>>
> >> --
> >> Jean-Baptiste Onofré
> >> jbonofre@apache.org
> >> http://blog.nanthrax.net
> >> Talend - http://www.talend.com
> >>
> >
> >
>
Re: [PROPOSAL] Beam FAQ
Posted by Devin Donnelly <dd...@google.com.INVALID>.
The relevant file you're looking for, and the one that's constantly
updated, is:
/docs/programming-guide.md
On Fri, May 27, 2016 at 5:20 PM, Devin Donnelly <dd...@google.com>
wrote:
> Here's the URL of my fork, so you can see what it looks like so far:
>
> https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
>
> On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
> wrote:
>
>> Agree, it would be great to have such user guide + a started guide for
>> Beam.
>>
>> Regards
>> JB
>>
>>
>> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
>>
>>> I think Josh's Crunch User Guide is a great example of what a user guide
>>> should cover. https://crunch.apache.org/user-guide.html
>>>
>>> On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com> wrote:
>>>
>>> Ok, I agree Davor for end users a getting started guide is not only
>>>> important but I would say critical at this moment, the FAQ can be an
>>>> effort
>>>> run in parallel. The project is incubating so the FAQ would be in its
>>>> early
>>>> state, and ideally we must not need an enormous FAQ, however this
>>>> project
>>>> mixes many different technologies, and I can easily imagine frequent
>>>> questions about technical details on Sources, Sinks, and Runners e.g. my
>>>> question on how to reuse the context on the spark runner is a good
>>>> example,
>>>> it is not general enough to put it as a default in the runner, it is not
>>>> simple enough for a getting started guide, but a good amount of users
>>>> will
>>>> have to deal with it once they write tests for their pipelines.
>>>>
>>>> Devin, thanks for writing, I am interested in the draft, can you please
>>>> share the URL of your fork, so other people can eventually take a
>>>> look/contribute.
>>>>
>>>> Ismael
>>>>
>>>>
>>>>
>>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
>>>> ddonnelly@google.com.invalid> wrote:
>>>>
>>>> FYI: User documentation draft (the Beam Programming Guide) is well
>>>>> underway. I'm regularly pushing stuff out to a fork of the Beam website
>>>>> repo if anyone wants a sneak peek.
>>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
>>>>>
>>>> wrote:
>>>>
>>>>>
>>>>> We are missing a basic getting started guide along with the rest of
>>>>>>
>>>>> user
>>>>
>>>>> documentation. I think we should work on this first.
>>>>>>
>>>>>> FAQ is a great idea for things that aren't or cannot be covered by
>>>>>>
>>>>> those
>>>>
>>>>> documents -- but, we cannot really start that before we have at least a
>>>>>> draft version of the previous.
>>>>>>
>>>>>> Wiki hosting would be owned by Infra, if we choose to go down that
>>>>>> path
>>>>>>
>>>>> at
>>>>>
>>>>>> some point.
>>>>>>
>>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <
>>>>>> jb@nanthrax.net
>>>>>>
>>>>>
>>>>> wrote:
>>>>>>
>>>>>> Hi,
>>>>>>>
>>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind of
>>>>>>> governance and review using the website.
>>>>>>>
>>>>>>> Regards
>>>>>>> JB
>>>>>>>
>>>>>>>
>>>>>>> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
>>>>>>>
>>>>>>> Hello,
>>>>>>>>
>>>>>>>> I have stumbled with some issues while trying to execute pipelines
>>>>>>>>
>>>>>>> with
>>>>>
>>>>>> all
>>>>>>>> the
>>>>>>>> different runners and I was wondering if we need to create a
>>>>>>>>
>>>>>>> Frequently
>>>>>
>>>>>> Asked
>>>>>>>> Questions (FAQ) section on the website. Maybe it would be better to
>>>>>>>>
>>>>>>> create
>>>>>>
>>>>>>> such
>>>>>>>> thing as a wiki so we can contribute faster.
>>>>>>>>
>>>>>>>> What do you think ? And what way you think is the better to do so
>>>>>>>>
>>>>>>> (infra)
>>>>>>
>>>>>>> ?
>>>>>>>>
>>>>>>>> Regards,
>>>>>>>> Ismaël
>>>>>>>>
>>>>>>>>
>>>>>>>> --
>>>>>>> Jean-Baptiste Onofré
>>>>>>> jbonofre@apache.org
>>>>>>> http://blog.nanthrax.net
>>>>>>> Talend - http://www.talend.com
>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>> --
>> Jean-Baptiste Onofré
>> jbonofre@apache.org
>> http://blog.nanthrax.net
>> Talend - http://www.talend.com
>>
>
>
Re: [PROPOSAL] Beam FAQ
Posted by Devin Donnelly <dd...@google.com.INVALID>.
Here's the URL of my fork, so you can see what it looks like so far:
https://github.com/devin-donnelly/incubator-beam-site/tree/beam-pg
On Mon, May 23, 2016 at 8:02 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
wrote:
> Agree, it would be great to have such user guide + a started guide for
> Beam.
>
> Regards
> JB
>
>
> On 05/23/2016 04:41 PM, Jesse Anderson wrote:
>
>> I think Josh's Crunch User Guide is a great example of what a user guide
>> should cover. https://crunch.apache.org/user-guide.html
>>
>> On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com> wrote:
>>
>> Ok, I agree Davor for end users a getting started guide is not only
>>> important but I would say critical at this moment, the FAQ can be an
>>> effort
>>> run in parallel. The project is incubating so the FAQ would be in its
>>> early
>>> state, and ideally we must not need an enormous FAQ, however this project
>>> mixes many different technologies, and I can easily imagine frequent
>>> questions about technical details on Sources, Sinks, and Runners e.g. my
>>> question on how to reuse the context on the spark runner is a good
>>> example,
>>> it is not general enough to put it as a default in the runner, it is not
>>> simple enough for a getting started guide, but a good amount of users
>>> will
>>> have to deal with it once they write tests for their pipelines.
>>>
>>> Devin, thanks for writing, I am interested in the draft, can you please
>>> share the URL of your fork, so other people can eventually take a
>>> look/contribute.
>>>
>>> Ismael
>>>
>>>
>>>
>>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
>>> ddonnelly@google.com.invalid> wrote:
>>>
>>> FYI: User documentation draft (the Beam Programming Guide) is well
>>>> underway. I'm regularly pushing stuff out to a fork of the Beam website
>>>> repo if anyone wants a sneak peek.
>>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
>>>>
>>> wrote:
>>>
>>>>
>>>> We are missing a basic getting started guide along with the rest of
>>>>>
>>>> user
>>>
>>>> documentation. I think we should work on this first.
>>>>>
>>>>> FAQ is a great idea for things that aren't or cannot be covered by
>>>>>
>>>> those
>>>
>>>> documents -- but, we cannot really start that before we have at least a
>>>>> draft version of the previous.
>>>>>
>>>>> Wiki hosting would be owned by Infra, if we choose to go down that path
>>>>>
>>>> at
>>>>
>>>>> some point.
>>>>>
>>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <jb@nanthrax.net
>>>>>
>>>>
>>>> wrote:
>>>>>
>>>>> Hi,
>>>>>>
>>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind of
>>>>>> governance and review using the website.
>>>>>>
>>>>>> Regards
>>>>>> JB
>>>>>>
>>>>>>
>>>>>> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
>>>>>>
>>>>>> Hello,
>>>>>>>
>>>>>>> I have stumbled with some issues while trying to execute pipelines
>>>>>>>
>>>>>> with
>>>>
>>>>> all
>>>>>>> the
>>>>>>> different runners and I was wondering if we need to create a
>>>>>>>
>>>>>> Frequently
>>>>
>>>>> Asked
>>>>>>> Questions (FAQ) section on the website. Maybe it would be better to
>>>>>>>
>>>>>> create
>>>>>
>>>>>> such
>>>>>>> thing as a wiki so we can contribute faster.
>>>>>>>
>>>>>>> What do you think ? And what way you think is the better to do so
>>>>>>>
>>>>>> (infra)
>>>>>
>>>>>> ?
>>>>>>>
>>>>>>> Regards,
>>>>>>> Ismaël
>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>> Jean-Baptiste Onofré
>>>>>> jbonofre@apache.org
>>>>>> http://blog.nanthrax.net
>>>>>> Talend - http://www.talend.com
>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
> --
> Jean-Baptiste Onofré
> jbonofre@apache.org
> http://blog.nanthrax.net
> Talend - http://www.talend.com
>
Re: [PROPOSAL] Beam FAQ
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Agree, it would be great to have such user guide + a started guide for Beam.
Regards
JB
On 05/23/2016 04:41 PM, Jesse Anderson wrote:
> I think Josh's Crunch User Guide is a great example of what a user guide
> should cover. https://crunch.apache.org/user-guide.html
>
> On Mon, May 23, 2016 at 2:00 AM Isma�l Mej�a <ie...@gmail.com> wrote:
>
>> Ok, I agree Davor for end users a getting started guide is not only
>> important but I would say critical at this moment, the FAQ can be an effort
>> run in parallel. The project is incubating so the FAQ would be in its early
>> state, and ideally we must not need an enormous FAQ, however this project
>> mixes many different technologies, and I can easily imagine frequent
>> questions about technical details on Sources, Sinks, and Runners e.g. my
>> question on how to reuse the context on the spark runner is a good example,
>> it is not general enough to put it as a default in the runner, it is not
>> simple enough for a getting started guide, but a good amount of users will
>> have to deal with it once they write tests for their pipelines.
>>
>> Devin, thanks for writing, I am interested in the draft, can you please
>> share the URL of your fork, so other people can eventually take a
>> look/contribute.
>>
>> Ismael
>>
>>
>>
>> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
>> ddonnelly@google.com.invalid> wrote:
>>
>>> FYI: User documentation draft (the Beam Programming Guide) is well
>>> underway. I'm regularly pushing stuff out to a fork of the Beam website
>>> repo if anyone wants a sneak peek.
>>> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
>> wrote:
>>>
>>>> We are missing a basic getting started guide along with the rest of
>> user
>>>> documentation. I think we should work on this first.
>>>>
>>>> FAQ is a great idea for things that aren't or cannot be covered by
>> those
>>>> documents -- but, we cannot really start that before we have at least a
>>>> draft version of the previous.
>>>>
>>>> Wiki hosting would be owned by Infra, if we choose to go down that path
>>> at
>>>> some point.
>>>>
>>>> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofr� <jb@nanthrax.net
>>>
>>>> wrote:
>>>>
>>>>> Hi,
>>>>>
>>>>> good idea for the FAQ. Not sure for the wiki: it would prefer kind of
>>>>> governance and review using the website.
>>>>>
>>>>> Regards
>>>>> JB
>>>>>
>>>>>
>>>>> On 05/20/2016 09:24 AM, Isma�l Mej�a wrote:
>>>>>
>>>>>> Hello,
>>>>>>
>>>>>> I have stumbled with some issues while trying to execute pipelines
>>> with
>>>>>> all
>>>>>> the
>>>>>> different runners and I was wondering if we need to create a
>>> Frequently
>>>>>> Asked
>>>>>> Questions (FAQ) section on the website. Maybe it would be better to
>>>> create
>>>>>> such
>>>>>> thing as a wiki so we can contribute faster.
>>>>>>
>>>>>> What do you think ? And what way you think is the better to do so
>>>> (infra)
>>>>>> ?
>>>>>>
>>>>>> Regards,
>>>>>> Isma�l
>>>>>>
>>>>>>
>>>>> --
>>>>> Jean-Baptiste Onofr�
>>>>> jbonofre@apache.org
>>>>> http://blog.nanthrax.net
>>>>> Talend - http://www.talend.com
>>>>>
>>>>
>>>
>>
>
--
Jean-Baptiste Onofr�
jbonofre@apache.org
http://blog.nanthrax.net
Talend - http://www.talend.com
Re: [PROPOSAL] Beam FAQ
Posted by Jesse Anderson <je...@smokinghand.com>.
I think Josh's Crunch User Guide is a great example of what a user guide
should cover. https://crunch.apache.org/user-guide.html
On Mon, May 23, 2016 at 2:00 AM Ismaël Mejía <ie...@gmail.com> wrote:
> Ok, I agree Davor for end users a getting started guide is not only
> important but I would say critical at this moment, the FAQ can be an effort
> run in parallel. The project is incubating so the FAQ would be in its early
> state, and ideally we must not need an enormous FAQ, however this project
> mixes many different technologies, and I can easily imagine frequent
> questions about technical details on Sources, Sinks, and Runners e.g. my
> question on how to reuse the context on the spark runner is a good example,
> it is not general enough to put it as a default in the runner, it is not
> simple enough for a getting started guide, but a good amount of users will
> have to deal with it once they write tests for their pipelines.
>
> Devin, thanks for writing, I am interested in the draft, can you please
> share the URL of your fork, so other people can eventually take a
> look/contribute.
>
> Ismael
>
>
>
> On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
> ddonnelly@google.com.invalid> wrote:
>
> > FYI: User documentation draft (the Beam Programming Guide) is well
> > underway. I'm regularly pushing stuff out to a fork of the Beam website
> > repo if anyone wants a sneak peek.
> > On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid>
> wrote:
> >
> > > We are missing a basic getting started guide along with the rest of
> user
> > > documentation. I think we should work on this first.
> > >
> > > FAQ is a great idea for things that aren't or cannot be covered by
> those
> > > documents -- but, we cannot really start that before we have at least a
> > > draft version of the previous.
> > >
> > > Wiki hosting would be owned by Infra, if we choose to go down that path
> > at
> > > some point.
> > >
> > > On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <jb@nanthrax.net
> >
> > > wrote:
> > >
> > > > Hi,
> > > >
> > > > good idea for the FAQ. Not sure for the wiki: it would prefer kind of
> > > > governance and review using the website.
> > > >
> > > > Regards
> > > > JB
> > > >
> > > >
> > > > On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
> > > >
> > > >> Hello,
> > > >>
> > > >> I have stumbled with some issues while trying to execute pipelines
> > with
> > > >> all
> > > >> the
> > > >> different runners and I was wondering if we need to create a
> > Frequently
> > > >> Asked
> > > >> Questions (FAQ) section on the website. Maybe it would be better to
> > > create
> > > >> such
> > > >> thing as a wiki so we can contribute faster.
> > > >>
> > > >> What do you think ? And what way you think is the better to do so
> > > (infra)
> > > >> ?
> > > >>
> > > >> Regards,
> > > >> Ismaël
> > > >>
> > > >>
> > > > --
> > > > Jean-Baptiste Onofré
> > > > jbonofre@apache.org
> > > > http://blog.nanthrax.net
> > > > Talend - http://www.talend.com
> > > >
> > >
> >
>
Re: [PROPOSAL] Beam FAQ
Posted by Ismaël Mejía <ie...@gmail.com>.
Ok, I agree Davor for end users a getting started guide is not only
important but I would say critical at this moment, the FAQ can be an effort
run in parallel. The project is incubating so the FAQ would be in its early
state, and ideally we must not need an enormous FAQ, however this project
mixes many different technologies, and I can easily imagine frequent
questions about technical details on Sources, Sinks, and Runners e.g. my
question on how to reuse the context on the spark runner is a good example,
it is not general enough to put it as a default in the runner, it is not
simple enough for a getting started guide, but a good amount of users will
have to deal with it once they write tests for their pipelines.
Devin, thanks for writing, I am interested in the draft, can you please
share the URL of your fork, so other people can eventually take a
look/contribute.
Ismael
On Fri, May 20, 2016 at 7:35 PM, Devin Donnelly <
ddonnelly@google.com.invalid> wrote:
> FYI: User documentation draft (the Beam Programming Guide) is well
> underway. I'm regularly pushing stuff out to a fork of the Beam website
> repo if anyone wants a sneak peek.
> On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid> wrote:
>
> > We are missing a basic getting started guide along with the rest of user
> > documentation. I think we should work on this first.
> >
> > FAQ is a great idea for things that aren't or cannot be covered by those
> > documents -- but, we cannot really start that before we have at least a
> > draft version of the previous.
> >
> > Wiki hosting would be owned by Infra, if we choose to go down that path
> at
> > some point.
> >
> > On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
> > wrote:
> >
> > > Hi,
> > >
> > > good idea for the FAQ. Not sure for the wiki: it would prefer kind of
> > > governance and review using the website.
> > >
> > > Regards
> > > JB
> > >
> > >
> > > On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
> > >
> > >> Hello,
> > >>
> > >> I have stumbled with some issues while trying to execute pipelines
> with
> > >> all
> > >> the
> > >> different runners and I was wondering if we need to create a
> Frequently
> > >> Asked
> > >> Questions (FAQ) section on the website. Maybe it would be better to
> > create
> > >> such
> > >> thing as a wiki so we can contribute faster.
> > >>
> > >> What do you think ? And what way you think is the better to do so
> > (infra)
> > >> ?
> > >>
> > >> Regards,
> > >> Ismaël
> > >>
> > >>
> > > --
> > > Jean-Baptiste Onofré
> > > jbonofre@apache.org
> > > http://blog.nanthrax.net
> > > Talend - http://www.talend.com
> > >
> >
>
Re: [PROPOSAL] Beam FAQ
Posted by Devin Donnelly <dd...@google.com.INVALID>.
FYI: User documentation draft (the Beam Programming Guide) is well
underway. I'm regularly pushing stuff out to a fork of the Beam website
repo if anyone wants a sneak peek.
On May 20, 2016 9:37 AM, "Davor Bonaci" <da...@google.com.invalid> wrote:
> We are missing a basic getting started guide along with the rest of user
> documentation. I think we should work on this first.
>
> FAQ is a great idea for things that aren't or cannot be covered by those
> documents -- but, we cannot really start that before we have at least a
> draft version of the previous.
>
> Wiki hosting would be owned by Infra, if we choose to go down that path at
> some point.
>
> On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
> wrote:
>
> > Hi,
> >
> > good idea for the FAQ. Not sure for the wiki: it would prefer kind of
> > governance and review using the website.
> >
> > Regards
> > JB
> >
> >
> > On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
> >
> >> Hello,
> >>
> >> I have stumbled with some issues while trying to execute pipelines with
> >> all
> >> the
> >> different runners and I was wondering if we need to create a Frequently
> >> Asked
> >> Questions (FAQ) section on the website. Maybe it would be better to
> create
> >> such
> >> thing as a wiki so we can contribute faster.
> >>
> >> What do you think ? And what way you think is the better to do so
> (infra)
> >> ?
> >>
> >> Regards,
> >> Ismaël
> >>
> >>
> > --
> > Jean-Baptiste Onofré
> > jbonofre@apache.org
> > http://blog.nanthrax.net
> > Talend - http://www.talend.com
> >
>
Re: [PROPOSAL] Beam FAQ
Posted by Davor Bonaci <da...@google.com.INVALID>.
We are missing a basic getting started guide along with the rest of user
documentation. I think we should work on this first.
FAQ is a great idea for things that aren't or cannot be covered by those
documents -- but, we cannot really start that before we have at least a
draft version of the previous.
Wiki hosting would be owned by Infra, if we choose to go down that path at
some point.
On Fri, May 20, 2016 at 1:34 AM, Jean-Baptiste Onofré <jb...@nanthrax.net>
wrote:
> Hi,
>
> good idea for the FAQ. Not sure for the wiki: it would prefer kind of
> governance and review using the website.
>
> Regards
> JB
>
>
> On 05/20/2016 09:24 AM, Ismaël Mejía wrote:
>
>> Hello,
>>
>> I have stumbled with some issues while trying to execute pipelines with
>> all
>> the
>> different runners and I was wondering if we need to create a Frequently
>> Asked
>> Questions (FAQ) section on the website. Maybe it would be better to create
>> such
>> thing as a wiki so we can contribute faster.
>>
>> What do you think ? And what way you think is the better to do so (infra)
>> ?
>>
>> Regards,
>> Ismaël
>>
>>
> --
> Jean-Baptiste Onofré
> jbonofre@apache.org
> http://blog.nanthrax.net
> Talend - http://www.talend.com
>
Re: [PROPOSAL] Beam FAQ
Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.
Hi,
good idea for the FAQ. Not sure for the wiki: it would prefer kind of
governance and review using the website.
Regards
JB
On 05/20/2016 09:24 AM, Isma�l Mej�a wrote:
> Hello,
>
> I have stumbled with some issues while trying to execute pipelines with all
> the
> different runners and I was wondering if we need to create a Frequently
> Asked
> Questions (FAQ) section on the website. Maybe it would be better to create
> such
> thing as a wiki so we can contribute faster.
>
> What do you think ? And what way you think is the better to do so (infra) ?
>
> Regards,
> Isma�l
>
--
Jean-Baptiste Onofr�
jbonofre@apache.org
http://blog.nanthrax.net
Talend - http://www.talend.com