apex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Chandni Singh <chan...@datatorrent.com>
Subject Re: Word Count Tutorial Failure
Date Thu, 19 Nov 2015 22:47:18 GMT
Sandesh,

I am not just referring to myself. I have worked with people who are not
committers and it doesn't take longer than 5 minutes.

Chandni

On Thu, Nov 19, 2015 at 2:42 PM, Sandesh Hegde <sandesh@datatorrent.com>
wrote:

> It doesn't matter how long the Apex committers takes to create "Your first
> application", If people outside this circle are taking more time then we
> need to examine our guides.
>
>
> On Thu, Nov 19, 2015 at 2:36 PM Chandni Singh <chandni@datatorrent.com>
> wrote:
>
> > Starting a project or creating a new executable project should honestly
> > take no longer than 5 minutes.
> >
> > This literally doesn't take more than 5 minutes as the way Ram has
> > described in
> > https://www.datatorrent.com/buildingapps under "Your first application"
> > section.
> >
> > Chandni
> >
> > On Thu, Nov 19, 2015 at 1:55 PM, Ganelin, Ilya <
> > Ilya.Ganelin@capitalone.com>
> > wrote:
> >
> > > Ram -
> > > I¹ve reviewed the Apex_Development_Setup page and the blog. I am not
> new
> > > to Apex, I¹ve built apps in Apex and understand the process but putting
> > > myself in as a newcomer to the project, given the existing
> documentation,
> > > it¹s still really confusing to get started. We¹re presently teaching
> > > others within C1 how to get Apex up and rolling and getting going from
> > > ground zero is far from easy.
> > >
> > > As a developer, the things that I need to be crystal clear and concise
> > are:
> > >
> > > 1) How do I get the codebase
> > > 2) How do I import the codebase into an IDE
> > > 3) How do I build and run examples
> > > 4) How do I create a new project, what do I need to add to maven to do
> > this
> > > 5) How do I build
> > > 6) How do I test
> > >
> > > At the moment, the documentation doesn¹t paint a clear picture of this.
> > > The present version is a massive improvement over what was there
> before,
> > > but at the moment there aren¹t a few clear steps, with minimal
> > > configuration and involvement that get a person rolling.
> > >
> > > Starting a project or creating a new executable project should honestly
> > > take no longer than 5 minutes.
> > >
> > > With regards to the top N tutorial, if it¹s too complicated to easily
> set
> > > up, let¹s have tutorials that aren¹t! A tutorial should illustrate
> basic
> > > concepts and be easy to get up and running, otherwise it¹s
> disheartening.
> > >
> > > Does this help clarify a little more?
> > >
> > >
> > >
> > > On 11/19/15, 11:47 AM, "Munagala Ramanath" <ram@datatorrent.com>
> wrote:
> > >
> > > >Ilya,
> > > >
> > > >Completely agree about starting from scratch. My suggestion to clone
> > > >the examples repo which
> > > >contains the entire TopNWords example project was in response to your
> > > >suggestion in item 5 of
> > > >your message.
> > > >
> > > >For a simpler "Hello World" project, the steps at
> > > >https://docs.datatorrent.com/apex_development_setup/
> > > >should work -- it involves running a just a couple of commands on the
> > > >comand line and, for those wanting
> > > >an even simpler process, a script is provided that automates things
> > > >even further.
> > > >
> > > >A similarly super-simple approach to gettting started is outlined in
> > > >my blog: https://www.datatorrent.com/buildingapps/
> > > >People can directly run many of the existing demos after building core
> > > >and malhar and then
> > > >experiment with modifying the sources of those demos.
> > > >
> > > >For a more substantial example like Top N Words, there is a fair bit
> > > >of code needed in multiple files;
> > > >the process outlined in the tutorial on the website is simply trying
> > > >to save some time by copying
> > > >existing files over from Malhar and making the minimal changes needed
> > > >to incorporate them into
> > > >a standalone project.
> > > >
> > > >For someone wanting to get involved with Apex, I think it is
> > > >imperative to get familiar with running tools like
> > > >git and maven from the command line, so the tutorials rely on those
> > tools.
> > > >
> > > >Please let me know if you run into problems with any of the above
> steps.
> > > >
> > > >Ram
> > > >
> > > >On Thu, Nov 19, 2015 at 11:07 AM, Ganelin, Ilya
> > > ><Ilya.Ganelin@capitalone.com> wrote:
> > > >> Ram - the use case I'm targeting is having someone create a new
> > project
> > > >>from scratch based on an example. This is a little bit different.
> This
> > > >>is why I was basing it on the documentation from the website.
> > > >>
> > > >> The above is a necessity for getting new members involved with the
> > > >>project.
> > > >>
> > > >>
> > > >>
> > > >> Thank you,
> > > >> Ilya Ganelin
> > > >>
> > > >>
> > > >>
> > > >> -----Original Message-----
> > > >> From: Munagala Ramanath
> > > >>[ram@datatorrent.com<mailto:ram@datatorrent.com>]
> > > >> Sent: Thursday, November 19, 2015 01:50 PM Eastern Standard Time
> > > >> To: dev@apex.incubator.apache.org
> > > >> Subject: Re: Word Count Tutorial Failure
> > > >>
> > > >>
> > > >> Ilya,
> > > >>
> > > >> Could you please clone: https://github.com/DataTorrent/examples
> > > >> You'll find the complete project in tutorials/topnwords/app
> > > >> You should be able to build it successfully with: mvn clean package
> > > >>-DskipTests
> > > >> I just tried it. Let me know if you run into any issues.
> > > >>
> > > >> Ram
> > > >>
> > > >>
> > > >> On Thu, Nov 19, 2015 at 10:18 AM, Ganelin, Ilya
> > > >> <Ilya.Ganelin@capitalone.com> wrote:
> > > >>> Hi all ­ I just attempted to follow the instructions here:
> > > >>> http://docs.datatorrent.com/tutorials/topnwords-c2/
> > > >>>
> > > >>> For standing up top N words in Java.
> > > >>>
> > > >>> As it stands, things did not work. I was using IntelliJ Idea 14.
> > There
> > > >>>were a number of issues, a short (not comprehensive) list is below.
> > > >>>
> > > >>>  1.  There are discrepancies between the selected language level
in
> > > >>>the project settings and certain constructs in the code
> > > >>>     *   In WordReader.java diamonds are used, which are only
> > supported
> > > >>>in java 7 but the language level is set to 5
> > > >>>  2.  The apex version is out of date in the pom.xml file (it¹s
set
> to
> > > >>>2.2)
> > > >>>  3.  ApplicationWithQuerySupport.java does not compile with newer
> > > >>>versions of Apex
> > > >>>
> > > >>> I spent about 15 minutes trying to get this thing to work in its
> > > >>>present state and it simply was not an easy and ready to roll
> example.
> > > >>>
> > > >>> General thoughts:
> > > >>>
> > > >>>  1.  We should not be asking users to manually copy example files
> > from
> > > >>>one place to another
> > > >>>  2.  We should not be asking them to rename packages to get things
> to
> > > >>>work
> > > >>>  3.  We should not be asking them to modify existing example code
> to
> > > >>>construct another example.
> > > >>>     *   I think a better approach is to provide a complete example
> > > >>>(that works out of the box) and that we can then walk through line
> by
> > > >>>line to explain what it¹s doing.
> > > >>>  4.  We shouldn¹t be asking them to copy-paste in settings.
> Instead,
> > > >>>we should walk them through what it means to set settings and have
a
> > > >>>simple enough example that it¹s straightforward to configure.
> > > >>>  5.  Standing up a word count example should be a 1-button-click
> > > >>>deployment that is ready to run without any user input. Any further
> > > >>>configuration should only be necessary for the sake of teaching,
not
> > > >>>for the sake of operationalizing the project.
> > > >>>
> > > >>> I hope this helps, I¹m happy to offer further feedback. Thanks!
> > > >>> ________________________________________________________
> > > >>>
> > > >>> The information contained in this e-mail is confidential and/or
> > > >>>proprietary to Capital One and/or its affiliates and may only be
> used
> > > >>>solely in performance of work or services for Capital One. The
> > > >>>information transmitted herewith is intended only for use by the
> > > >>>individual or entity to which it is addressed. If the reader of
this
> > > >>>message is not the intended recipient, you are hereby notified
that
> > any
> > > >>>review, retransmission, dissemination, distribution, copying or
> other
> > > >>>use of, or taking of any action in reliance upon this information
is
> > > >>>strictly prohibited. If you have received this communication in
> error,
> > > >>>please contact the sender and delete the material from your
> computer.
> > > >> ________________________________________________________
> > > >>
> > > >> The information contained in this e-mail is confidential and/or
> > > >>proprietary to Capital One and/or its affiliates and may only be used
> > > >>solely in performance of work or services for Capital One. The
> > > >>information transmitted herewith is intended only for use by the
> > > >>individual or entity to which it is addressed. If the reader of this
> > > >>message is not the intended recipient, you are hereby notified that
> any
> > > >>review, retransmission, dissemination, distribution, copying or other
> > > >>use of, or taking of any action in reliance upon this information is
> > > >>strictly prohibited. If you have received this communication in
> error,
> > > >>please contact the sender and delete the material from your computer.
> > >
> > > ________________________________________________________
> > >
> > > The information contained in this e-mail is confidential and/or
> > > proprietary to Capital One and/or its affiliates and may only be used
> > > solely in performance of work or services for Capital One. The
> > information
> > > transmitted herewith is intended only for use by the individual or
> entity
> > > to which it is addressed. If the reader of this message is not the
> > intended
> > > recipient, you are hereby notified that any review, retransmission,
> > > dissemination, distribution, copying or other use of, or taking of any
> > > action in reliance upon this information is strictly prohibited. If you
> > > have received this communication in error, please contact the sender
> and
> > > delete the material from your computer.
> > >
> > >
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message