You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@accumulo.apache.org by "Adam J. Shook" <ad...@gmail.com> on 2014/11/10 18:43:00 UTC

Contribute Examples/Exercises

I had just finished finalizing the training materials for a basic and
advanced Accumulo class my company ClearEdge IT offers.  I think some of
the more advanced code tutorials would be valuable to contribute to the
Accumulo examples library.

The examples all work with status updates from Twitter and include topics
such as:

   - Basic Reading/Writing
   - Indexing tweets and creating a program to retrieve tweets based on
   given search terms
   - Bulk ingestion of the tweets
   - Using MapReduce to building a geo-index table for the tweets with
   latitude/longitude information via z-points
   - Levering the geo-index to retrieve tweets from a given lat/long
   bounding box
   - Custom iterators such as filters and combiners

If this is something the community would be interested in, please take the
time to review them at https://github.com/adamjshook/accumulo-training and
let me know if there are any you think would be worth contributing.  I'd be
happy to take the time to massage them to meet the standards.

Cheers,
--Adam

Re: Contribute Examples/Exercises

Posted by Chris Rigano <ch...@gmail.com>.
I am your man as I can never understand :-) Am in class. Will crack on it
Sunday.

Monica just got back from TDY ...

We all miss you ...

All the Best,

Chris

On Tue, Nov 11, 2014 at 9:58 AM, David Medinets <da...@gmail.com>
wrote:

> Can you add descriptions of the exercises to the README file? Many
> people finding that page would move to the next one with details to
> catch their interest.
>
> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano <ch...@gmail.com>
> wrote:
> > I believe they would be of benefit.
> >
> > On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook <ad...@gmail.com>
> > wrote:
> >
> >> I had just finished finalizing the training materials for a basic and
> >> advanced Accumulo class my company ClearEdge IT offers.  I think some of
> >> the more advanced code tutorials would be valuable to contribute to the
> >> Accumulo examples library.
> >>
> >> The examples all work with status updates from Twitter and include
> topics
> >> such as:
> >>
> >>    - Basic Reading/Writing
> >>    - Indexing tweets and creating a program to retrieve tweets based on
> >>    given search terms
> >>    - Bulk ingestion of the tweets
> >>    - Using MapReduce to building a geo-index table for the tweets with
> >>    latitude/longitude information via z-points
> >>    - Levering the geo-index to retrieve tweets from a given lat/long
> >>    bounding box
> >>    - Custom iterators such as filters and combiners
> >>
> >> If this is something the community would be interested in, please take
> the
> >> time to review them at https://github.com/adamjshook/accumulo-training
> and
> >> let me know if there are any you think would be worth contributing.
> I'd be
> >> happy to take the time to massage them to meet the standards.
> >>
> >> Cheers,
> >> --Adam
> >>
>

Re: Contribute Examples/Exercises

Posted by Mike Drob <ma...@cloudera.com>.
+1 to setting up a Jenkins Job.

On Fri, Nov 14, 2014 at 12:14 PM, Josh Elser <jo...@gmail.com> wrote:

> Since there's an opinion to create an examples repo instead of keeping
> them in the base project, I'm -0 as long we CI set up so that they don't go
> silently into the night as I previously state as a concern.
>
> Some general questions for actually doing this: do we schedule the move of
> the classes out of the main project for 1.7.0? Will this other repo follow
> the same development practices as the project (e.g. branch names). How will
> we release these examples?
>
> Can someone step up to make sure all of the above are completed/addressed
> and file the necessary INFRA JIRA issues?
>
>
> David Medinets wrote:
>
>> +1
>> On Nov 14, 2014 11:18 AM, "Keith Turner"<ke...@deenlo.com>  wrote:
>>
>>  On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet<cj...@gmail.com>  wrote:
>>>
>>>  Josh,
>>>>
>>>>  My worry with a contrib module is that, historically, code which goes
>>>>>
>>>> moves to a contrib is just one step away from the grave.
>>>>
>>>> You do have a good point. My hope was that this could be the beginning
>>>> of
>>>> our changing history so that we could begin to encourage the community
>>>> to
>>>> contribute their own source directly and give them an outlet for doing
>>>>
>>> so.
>>>
>>>> I understand that's also the intent of hosting open source repos under
>>>>
>>> ASF
>>>
>>>> to begin with- so I'm partial to either outcome.
>>>>
>>>>  I think there's precedence for keeping them in core (as Christopher had
>>>>>
>>>> mentioned, next to examples/simple) which would benefit people
>>>> externally
>>>> (more "how do I do X" examples) and internally (keep devs honest about
>>>>
>>> how
>>>
>>>> our APIs are implemented).
>>>>
>>>> I would think that would just require keeping the repos up to date as
>>>> versions change so they wouldn't get out of date and possibly releasing
>>>> them w/ our other releases.
>>>>
>>>>
>>>> Wherever they end up living, thank you Adam for the contributions!
>>>>
>>>>  I'll 2nd that.
>>>
>>> For the following reasons, I think it might be nice to move existing
>>> examples out of core into their own git repo(s).
>>>
>>>   * Examples would be based on released version of Accumulo
>>>   * Examples could easily be built w/o building all of Accumulo
>>>   * As Sean said, this would keep us honest
>>>   * The examples poms would serve as examples more than they do when
>>> part of
>>> Accumulo build
>>>   * Less likely to use non public APIs in examples
>>>
>>>
>>>
>>>>
>>>> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser<jo...@gmail.com>
>>>>
>>> wrote:
>>>
>>>> My worry with a contrib module is that, historically, code which goes
>>>>> moves to a contrib is just one step away from the grave. I think
>>>>>
>>>> there's
>>>
>>>> precedence for keeping them in core (as Christopher had mentioned, next
>>>>>
>>>> to
>>>>
>>>>> examples/simple) which would benefit people externally (more "how do I
>>>>>
>>>> do
>>>
>>>> X" examples) and internally (keep devs honest about how our APIs are
>>>>> implemented).
>>>>>
>>>>> Bringing the examples into the core also encourages us to grow the
>>>>> community which has been stagnant with respect to new committers for
>>>>>
>>>> about
>>>>
>>>>> 9 months now.
>>>>>
>>>>>
>>>>> Corey Nolet wrote:
>>>>>
>>>>>  +1 for adding the examples to contrib.
>>>>>>
>>>>>> I was, myself, reading over this email wondering how a set of 11
>>>>>>
>>>>> separate
>>>>
>>>>> examples on the use of Accumulo would fit into the core codebase-
>>>>>> especially as more are contributed over tinme. I like the idea of
>>>>>>
>>>>> giving
>>>
>>>> community members an outlet for contributing examples that they've
>>>>>>
>>>>> built
>>>
>>>> so
>>>>>> that we can continue to foster that without having to fit them in the
>>>>>>
>>>>> core
>>>>
>>>>> codebase. It just seems more maintainable.
>>>>>>
>>>>>>
>>>>>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
>>>>>>
>>>>> wrote:
>>>>
>>>>>   I'll take that as you disagree with my consideration of
>>>>>>
>>>>> "substantial".
>>>
>>>> Thanks.
>>>>>>>
>>>>>>>
>>>>>>> Mike Drob wrote:
>>>>>>>
>>>>>>>   The proposed contribution is a collection of 11 examples. It's
>>>>>>>
>>>>>> clearly
>>>
>>>> non-trivial, which is probably enough to be considered "substantial"
>>>>>>>>
>>>>>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>>
>>>>>>>>   Sean Busbey wrote:
>>>>>>>>
>>>>>>>>>    On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
>>>>>>>>>
>>>>>>>> josh.elser@gmail.com>
>>>
>>>> wrote:
>>>>>>>>>>
>>>>>>>>>>     Personally, I didn't really think that this contribution was
>>>>>>>>>> in
>>>>>>>>>>
>>>>>>>>> the
>>>>
>>>>>   spirit
>>>>>>>>>>
>>>>>>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>>>>>>
>>>>>>>>>>> Some extra examples which leverage what Accumulo already does
>>>>>>>>>>>
>>>>>>>>>> seems
>>>
>>>> more
>>>>>>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>     It's content developed out side of the project list. That's
>>>>>>>>>>>
>>>>>>>>>> all
>>>
>>>> it
>>>>
>>>>>   takes to
>>>>>>>>>>>
>>>>>>>>>> require the trip through the Incubator checks as far as the ASF
>>>>>>>>>> guidelines
>>>>>>>>>> are concerned.
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>     From http://incubator.apache.org/ip-clearance/index.html
>>>>>>>>>>
>>>>>>>>>>  """
>>>>>>>>>    From time to time, an external codebase is brought into the ASF
>>>>>>>>>
>>>>>>>> that
>>>>
>>>>> is
>>>>>>>>> not a separate incubating project but still represents a
>>>>>>>>>
>>>>>>>> substantial
>>>
>>>> contribution that was not developed within the ASF's source control
>>>>>>>>> system
>>>>>>>>> and on our public mailing lists.
>>>>>>>>> """
>>>>>>>>>
>>>>>>>>> Not to look a gift-horse in the mouth (it is great work), but I
>>>>>>>>>
>>>>>>>> don't
>>>
>>>> see
>>>>>>>>> these examples as "substantial". I haven't found guidelines yet
>>>>>>>>>
>>>>>>>> that
>>>
>>>> better
>>>>>>>>> clarify the definition of "substantial".
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>

Re: Contribute Examples/Exercises

Posted by Keith Turner <ke...@deenlo.com>.
On Fri, Nov 14, 2014 at 1:57 PM, Mike Drob <ma...@cloudera.com> wrote:

> Having done this in the past, I have a hard time suggesting this approach.
>

never tried it.  Was there anything else you did not like about it (other
than being useless for bisect)?  The history would still be in accumulo
repo.


> As a single module, the code probably won't compile for most of the history
> that we preserve, so it's not like we'd be able to efficiently bisect or
> take advantage of the history.
>
> On Fri, Nov 14, 2014 at 12:29 PM, Keith Turner <ke...@deenlo.com> wrote:
>
> > We can try using git fitler-branch to create the repo and preserve
> history.
> >
> > On Fri, Nov 14, 2014 at 1:14 PM, Josh Elser <jo...@gmail.com>
> wrote:
> >
> > > Since there's an opinion to create an examples repo instead of keeping
> > > them in the base project, I'm -0 as long we CI set up so that they
> don't
> > go
> > > silently into the night as I previously state as a concern.
> > >
> > > Some general questions for actually doing this: do we schedule the move
> > of
> > > the classes out of the main project for 1.7.0? Will this other repo
> > follow
> > > the same development practices as the project (e.g. branch names). How
> > will
> > > we release these examples?
> > >
> > > Can someone step up to make sure all of the above are
> completed/addressed
> > > and file the necessary INFRA JIRA issues?
> > >
> > >
> > > David Medinets wrote:
> > >
> > >> +1
> > >> On Nov 14, 2014 11:18 AM, "Keith Turner"<ke...@deenlo.com>  wrote:
> > >>
> > >>  On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet<cj...@gmail.com>
> > wrote:
> > >>>
> > >>>  Josh,
> > >>>>
> > >>>>  My worry with a contrib module is that, historically, code which
> goes
> > >>>>>
> > >>>> moves to a contrib is just one step away from the grave.
> > >>>>
> > >>>> You do have a good point. My hope was that this could be the
> beginning
> > >>>> of
> > >>>> our changing history so that we could begin to encourage the
> community
> > >>>> to
> > >>>> contribute their own source directly and give them an outlet for
> doing
> > >>>>
> > >>> so.
> > >>>
> > >>>> I understand that's also the intent of hosting open source repos
> under
> > >>>>
> > >>> ASF
> > >>>
> > >>>> to begin with- so I'm partial to either outcome.
> > >>>>
> > >>>>  I think there's precedence for keeping them in core (as Christopher
> > had
> > >>>>>
> > >>>> mentioned, next to examples/simple) which would benefit people
> > >>>> externally
> > >>>> (more "how do I do X" examples) and internally (keep devs honest
> about
> > >>>>
> > >>> how
> > >>>
> > >>>> our APIs are implemented).
> > >>>>
> > >>>> I would think that would just require keeping the repos up to date
> as
> > >>>> versions change so they wouldn't get out of date and possibly
> > releasing
> > >>>> them w/ our other releases.
> > >>>>
> > >>>>
> > >>>> Wherever they end up living, thank you Adam for the contributions!
> > >>>>
> > >>>>  I'll 2nd that.
> > >>>
> > >>> For the following reasons, I think it might be nice to move existing
> > >>> examples out of core into their own git repo(s).
> > >>>
> > >>>   * Examples would be based on released version of Accumulo
> > >>>   * Examples could easily be built w/o building all of Accumulo
> > >>>   * As Sean said, this would keep us honest
> > >>>   * The examples poms would serve as examples more than they do when
> > >>> part of
> > >>> Accumulo build
> > >>>   * Less likely to use non public APIs in examples
> > >>>
> > >>>
> > >>>
> > >>>>
> > >>>> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser<jo...@gmail.com>
> > >>>>
> > >>> wrote:
> > >>>
> > >>>> My worry with a contrib module is that, historically, code which
> goes
> > >>>>> moves to a contrib is just one step away from the grave. I think
> > >>>>>
> > >>>> there's
> > >>>
> > >>>> precedence for keeping them in core (as Christopher had mentioned,
> > next
> > >>>>>
> > >>>> to
> > >>>>
> > >>>>> examples/simple) which would benefit people externally (more "how
> do
> > I
> > >>>>>
> > >>>> do
> > >>>
> > >>>> X" examples) and internally (keep devs honest about how our APIs are
> > >>>>> implemented).
> > >>>>>
> > >>>>> Bringing the examples into the core also encourages us to grow the
> > >>>>> community which has been stagnant with respect to new committers
> for
> > >>>>>
> > >>>> about
> > >>>>
> > >>>>> 9 months now.
> > >>>>>
> > >>>>>
> > >>>>> Corey Nolet wrote:
> > >>>>>
> > >>>>>  +1 for adding the examples to contrib.
> > >>>>>>
> > >>>>>> I was, myself, reading over this email wondering how a set of 11
> > >>>>>>
> > >>>>> separate
> > >>>>
> > >>>>> examples on the use of Accumulo would fit into the core codebase-
> > >>>>>> especially as more are contributed over tinme. I like the idea of
> > >>>>>>
> > >>>>> giving
> > >>>
> > >>>> community members an outlet for contributing examples that they've
> > >>>>>>
> > >>>>> built
> > >>>
> > >>>> so
> > >>>>>> that we can continue to foster that without having to fit them in
> > the
> > >>>>>>
> > >>>>> core
> > >>>>
> > >>>>> codebase. It just seems more maintainable.
> > >>>>>>
> > >>>>>>
> > >>>>>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > >>>>>>
> > >>>>> wrote:
> > >>>>
> > >>>>>   I'll take that as you disagree with my consideration of
> > >>>>>>
> > >>>>> "substantial".
> > >>>
> > >>>> Thanks.
> > >>>>>>>
> > >>>>>>>
> > >>>>>>> Mike Drob wrote:
> > >>>>>>>
> > >>>>>>>   The proposed contribution is a collection of 11 examples. It's
> > >>>>>>>
> > >>>>>> clearly
> > >>>
> > >>>> non-trivial, which is probably enough to be considered "substantial"
> > >>>>>>>>
> > >>>>>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<
> josh.elser@gmail.com
> > >
> > >>>>>>>> wrote:
> > >>>>>>>>
> > >>>>>>>>
> > >>>>>>>>   Sean Busbey wrote:
> > >>>>>>>>
> > >>>>>>>>>    On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> > >>>>>>>>>
> > >>>>>>>> josh.elser@gmail.com>
> > >>>
> > >>>> wrote:
> > >>>>>>>>>>
> > >>>>>>>>>>     Personally, I didn't really think that this contribution
> was
> > >>>>>>>>>> in
> > >>>>>>>>>>
> > >>>>>>>>> the
> > >>>>
> > >>>>>   spirit
> > >>>>>>>>>>
> > >>>>>>>>>>> of what the new codebase adoption guidelines were meant to
> > cover.
> > >>>>>>>>>>>
> > >>>>>>>>>>> Some extra examples which leverage what Accumulo already does
> > >>>>>>>>>>>
> > >>>>>>>>>> seems
> > >>>
> > >>>> more
> > >>>>>>>>>>> like improvements for new Accumulo users than anything else.
> > >>>>>>>>>>>
> > >>>>>>>>>>>
> > >>>>>>>>>>>     It's content developed out side of the project list.
> That's
> > >>>>>>>>>>>
> > >>>>>>>>>> all
> > >>>
> > >>>> it
> > >>>>
> > >>>>>   takes to
> > >>>>>>>>>>>
> > >>>>>>>>>> require the trip through the Incubator checks as far as the
> ASF
> > >>>>>>>>>> guidelines
> > >>>>>>>>>> are concerned.
> > >>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>>
> > >>>>>>>>>>     From http://incubator.apache.org/ip-clearance/index.html
> > >>>>>>>>>>
> > >>>>>>>>>>  """
> > >>>>>>>>>    From time to time, an external codebase is brought into the
> > ASF
> > >>>>>>>>>
> > >>>>>>>> that
> > >>>>
> > >>>>> is
> > >>>>>>>>> not a separate incubating project but still represents a
> > >>>>>>>>>
> > >>>>>>>> substantial
> > >>>
> > >>>> contribution that was not developed within the ASF's source control
> > >>>>>>>>> system
> > >>>>>>>>> and on our public mailing lists.
> > >>>>>>>>> """
> > >>>>>>>>>
> > >>>>>>>>> Not to look a gift-horse in the mouth (it is great work), but I
> > >>>>>>>>>
> > >>>>>>>> don't
> > >>>
> > >>>> see
> > >>>>>>>>> these examples as "substantial". I haven't found guidelines yet
> > >>>>>>>>>
> > >>>>>>>> that
> > >>>
> > >>>> better
> > >>>>>>>>> clarify the definition of "substantial".
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >>>>>>>>>
> > >>
> >
>

Re: Contribute Examples/Exercises

Posted by Mike Drob <ma...@cloudera.com>.
Having done this in the past, I have a hard time suggesting this approach.
As a single module, the code probably won't compile for most of the history
that we preserve, so it's not like we'd be able to efficiently bisect or
take advantage of the history.

On Fri, Nov 14, 2014 at 12:29 PM, Keith Turner <ke...@deenlo.com> wrote:

> We can try using git fitler-branch to create the repo and preserve history.
>
> On Fri, Nov 14, 2014 at 1:14 PM, Josh Elser <jo...@gmail.com> wrote:
>
> > Since there's an opinion to create an examples repo instead of keeping
> > them in the base project, I'm -0 as long we CI set up so that they don't
> go
> > silently into the night as I previously state as a concern.
> >
> > Some general questions for actually doing this: do we schedule the move
> of
> > the classes out of the main project for 1.7.0? Will this other repo
> follow
> > the same development practices as the project (e.g. branch names). How
> will
> > we release these examples?
> >
> > Can someone step up to make sure all of the above are completed/addressed
> > and file the necessary INFRA JIRA issues?
> >
> >
> > David Medinets wrote:
> >
> >> +1
> >> On Nov 14, 2014 11:18 AM, "Keith Turner"<ke...@deenlo.com>  wrote:
> >>
> >>  On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet<cj...@gmail.com>
> wrote:
> >>>
> >>>  Josh,
> >>>>
> >>>>  My worry with a contrib module is that, historically, code which goes
> >>>>>
> >>>> moves to a contrib is just one step away from the grave.
> >>>>
> >>>> You do have a good point. My hope was that this could be the beginning
> >>>> of
> >>>> our changing history so that we could begin to encourage the community
> >>>> to
> >>>> contribute their own source directly and give them an outlet for doing
> >>>>
> >>> so.
> >>>
> >>>> I understand that's also the intent of hosting open source repos under
> >>>>
> >>> ASF
> >>>
> >>>> to begin with- so I'm partial to either outcome.
> >>>>
> >>>>  I think there's precedence for keeping them in core (as Christopher
> had
> >>>>>
> >>>> mentioned, next to examples/simple) which would benefit people
> >>>> externally
> >>>> (more "how do I do X" examples) and internally (keep devs honest about
> >>>>
> >>> how
> >>>
> >>>> our APIs are implemented).
> >>>>
> >>>> I would think that would just require keeping the repos up to date as
> >>>> versions change so they wouldn't get out of date and possibly
> releasing
> >>>> them w/ our other releases.
> >>>>
> >>>>
> >>>> Wherever they end up living, thank you Adam for the contributions!
> >>>>
> >>>>  I'll 2nd that.
> >>>
> >>> For the following reasons, I think it might be nice to move existing
> >>> examples out of core into their own git repo(s).
> >>>
> >>>   * Examples would be based on released version of Accumulo
> >>>   * Examples could easily be built w/o building all of Accumulo
> >>>   * As Sean said, this would keep us honest
> >>>   * The examples poms would serve as examples more than they do when
> >>> part of
> >>> Accumulo build
> >>>   * Less likely to use non public APIs in examples
> >>>
> >>>
> >>>
> >>>>
> >>>> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser<jo...@gmail.com>
> >>>>
> >>> wrote:
> >>>
> >>>> My worry with a contrib module is that, historically, code which goes
> >>>>> moves to a contrib is just one step away from the grave. I think
> >>>>>
> >>>> there's
> >>>
> >>>> precedence for keeping them in core (as Christopher had mentioned,
> next
> >>>>>
> >>>> to
> >>>>
> >>>>> examples/simple) which would benefit people externally (more "how do
> I
> >>>>>
> >>>> do
> >>>
> >>>> X" examples) and internally (keep devs honest about how our APIs are
> >>>>> implemented).
> >>>>>
> >>>>> Bringing the examples into the core also encourages us to grow the
> >>>>> community which has been stagnant with respect to new committers for
> >>>>>
> >>>> about
> >>>>
> >>>>> 9 months now.
> >>>>>
> >>>>>
> >>>>> Corey Nolet wrote:
> >>>>>
> >>>>>  +1 for adding the examples to contrib.
> >>>>>>
> >>>>>> I was, myself, reading over this email wondering how a set of 11
> >>>>>>
> >>>>> separate
> >>>>
> >>>>> examples on the use of Accumulo would fit into the core codebase-
> >>>>>> especially as more are contributed over tinme. I like the idea of
> >>>>>>
> >>>>> giving
> >>>
> >>>> community members an outlet for contributing examples that they've
> >>>>>>
> >>>>> built
> >>>
> >>>> so
> >>>>>> that we can continue to foster that without having to fit them in
> the
> >>>>>>
> >>>>> core
> >>>>
> >>>>> codebase. It just seems more maintainable.
> >>>>>>
> >>>>>>
> >>>>>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> >>>>>>
> >>>>> wrote:
> >>>>
> >>>>>   I'll take that as you disagree with my consideration of
> >>>>>>
> >>>>> "substantial".
> >>>
> >>>> Thanks.
> >>>>>>>
> >>>>>>>
> >>>>>>> Mike Drob wrote:
> >>>>>>>
> >>>>>>>   The proposed contribution is a collection of 11 examples. It's
> >>>>>>>
> >>>>>> clearly
> >>>
> >>>> non-trivial, which is probably enough to be considered "substantial"
> >>>>>>>>
> >>>>>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<josh.elser@gmail.com
> >
> >>>>>>>> wrote:
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>   Sean Busbey wrote:
> >>>>>>>>
> >>>>>>>>>    On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> >>>>>>>>>
> >>>>>>>> josh.elser@gmail.com>
> >>>
> >>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>>     Personally, I didn't really think that this contribution was
> >>>>>>>>>> in
> >>>>>>>>>>
> >>>>>>>>> the
> >>>>
> >>>>>   spirit
> >>>>>>>>>>
> >>>>>>>>>>> of what the new codebase adoption guidelines were meant to
> cover.
> >>>>>>>>>>>
> >>>>>>>>>>> Some extra examples which leverage what Accumulo already does
> >>>>>>>>>>>
> >>>>>>>>>> seems
> >>>
> >>>> more
> >>>>>>>>>>> like improvements for new Accumulo users than anything else.
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>     It's content developed out side of the project list. That's
> >>>>>>>>>>>
> >>>>>>>>>> all
> >>>
> >>>> it
> >>>>
> >>>>>   takes to
> >>>>>>>>>>>
> >>>>>>>>>> require the trip through the Incubator checks as far as the ASF
> >>>>>>>>>> guidelines
> >>>>>>>>>> are concerned.
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>>     From http://incubator.apache.org/ip-clearance/index.html
> >>>>>>>>>>
> >>>>>>>>>>  """
> >>>>>>>>>    From time to time, an external codebase is brought into the
> ASF
> >>>>>>>>>
> >>>>>>>> that
> >>>>
> >>>>> is
> >>>>>>>>> not a separate incubating project but still represents a
> >>>>>>>>>
> >>>>>>>> substantial
> >>>
> >>>> contribution that was not developed within the ASF's source control
> >>>>>>>>> system
> >>>>>>>>> and on our public mailing lists.
> >>>>>>>>> """
> >>>>>>>>>
> >>>>>>>>> Not to look a gift-horse in the mouth (it is great work), but I
> >>>>>>>>>
> >>>>>>>> don't
> >>>
> >>>> see
> >>>>>>>>> these examples as "substantial". I haven't found guidelines yet
> >>>>>>>>>
> >>>>>>>> that
> >>>
> >>>> better
> >>>>>>>>> clarify the definition of "substantial".
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>>
> >>
>

Re: Contribute Examples/Exercises

Posted by Keith Turner <ke...@deenlo.com>.
We can try using git fitler-branch to create the repo and preserve history.

On Fri, Nov 14, 2014 at 1:14 PM, Josh Elser <jo...@gmail.com> wrote:

> Since there's an opinion to create an examples repo instead of keeping
> them in the base project, I'm -0 as long we CI set up so that they don't go
> silently into the night as I previously state as a concern.
>
> Some general questions for actually doing this: do we schedule the move of
> the classes out of the main project for 1.7.0? Will this other repo follow
> the same development practices as the project (e.g. branch names). How will
> we release these examples?
>
> Can someone step up to make sure all of the above are completed/addressed
> and file the necessary INFRA JIRA issues?
>
>
> David Medinets wrote:
>
>> +1
>> On Nov 14, 2014 11:18 AM, "Keith Turner"<ke...@deenlo.com>  wrote:
>>
>>  On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet<cj...@gmail.com>  wrote:
>>>
>>>  Josh,
>>>>
>>>>  My worry with a contrib module is that, historically, code which goes
>>>>>
>>>> moves to a contrib is just one step away from the grave.
>>>>
>>>> You do have a good point. My hope was that this could be the beginning
>>>> of
>>>> our changing history so that we could begin to encourage the community
>>>> to
>>>> contribute their own source directly and give them an outlet for doing
>>>>
>>> so.
>>>
>>>> I understand that's also the intent of hosting open source repos under
>>>>
>>> ASF
>>>
>>>> to begin with- so I'm partial to either outcome.
>>>>
>>>>  I think there's precedence for keeping them in core (as Christopher had
>>>>>
>>>> mentioned, next to examples/simple) which would benefit people
>>>> externally
>>>> (more "how do I do X" examples) and internally (keep devs honest about
>>>>
>>> how
>>>
>>>> our APIs are implemented).
>>>>
>>>> I would think that would just require keeping the repos up to date as
>>>> versions change so they wouldn't get out of date and possibly releasing
>>>> them w/ our other releases.
>>>>
>>>>
>>>> Wherever they end up living, thank you Adam for the contributions!
>>>>
>>>>  I'll 2nd that.
>>>
>>> For the following reasons, I think it might be nice to move existing
>>> examples out of core into their own git repo(s).
>>>
>>>   * Examples would be based on released version of Accumulo
>>>   * Examples could easily be built w/o building all of Accumulo
>>>   * As Sean said, this would keep us honest
>>>   * The examples poms would serve as examples more than they do when
>>> part of
>>> Accumulo build
>>>   * Less likely to use non public APIs in examples
>>>
>>>
>>>
>>>>
>>>> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser<jo...@gmail.com>
>>>>
>>> wrote:
>>>
>>>> My worry with a contrib module is that, historically, code which goes
>>>>> moves to a contrib is just one step away from the grave. I think
>>>>>
>>>> there's
>>>
>>>> precedence for keeping them in core (as Christopher had mentioned, next
>>>>>
>>>> to
>>>>
>>>>> examples/simple) which would benefit people externally (more "how do I
>>>>>
>>>> do
>>>
>>>> X" examples) and internally (keep devs honest about how our APIs are
>>>>> implemented).
>>>>>
>>>>> Bringing the examples into the core also encourages us to grow the
>>>>> community which has been stagnant with respect to new committers for
>>>>>
>>>> about
>>>>
>>>>> 9 months now.
>>>>>
>>>>>
>>>>> Corey Nolet wrote:
>>>>>
>>>>>  +1 for adding the examples to contrib.
>>>>>>
>>>>>> I was, myself, reading over this email wondering how a set of 11
>>>>>>
>>>>> separate
>>>>
>>>>> examples on the use of Accumulo would fit into the core codebase-
>>>>>> especially as more are contributed over tinme. I like the idea of
>>>>>>
>>>>> giving
>>>
>>>> community members an outlet for contributing examples that they've
>>>>>>
>>>>> built
>>>
>>>> so
>>>>>> that we can continue to foster that without having to fit them in the
>>>>>>
>>>>> core
>>>>
>>>>> codebase. It just seems more maintainable.
>>>>>>
>>>>>>
>>>>>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
>>>>>>
>>>>> wrote:
>>>>
>>>>>   I'll take that as you disagree with my consideration of
>>>>>>
>>>>> "substantial".
>>>
>>>> Thanks.
>>>>>>>
>>>>>>>
>>>>>>> Mike Drob wrote:
>>>>>>>
>>>>>>>   The proposed contribution is a collection of 11 examples. It's
>>>>>>>
>>>>>> clearly
>>>
>>>> non-trivial, which is probably enough to be considered "substantial"
>>>>>>>>
>>>>>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>>>>>>> wrote:
>>>>>>>>
>>>>>>>>
>>>>>>>>   Sean Busbey wrote:
>>>>>>>>
>>>>>>>>>    On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
>>>>>>>>>
>>>>>>>> josh.elser@gmail.com>
>>>
>>>> wrote:
>>>>>>>>>>
>>>>>>>>>>     Personally, I didn't really think that this contribution was
>>>>>>>>>> in
>>>>>>>>>>
>>>>>>>>> the
>>>>
>>>>>   spirit
>>>>>>>>>>
>>>>>>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>>>>>>
>>>>>>>>>>> Some extra examples which leverage what Accumulo already does
>>>>>>>>>>>
>>>>>>>>>> seems
>>>
>>>> more
>>>>>>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>>>>>>
>>>>>>>>>>>
>>>>>>>>>>>     It's content developed out side of the project list. That's
>>>>>>>>>>>
>>>>>>>>>> all
>>>
>>>> it
>>>>
>>>>>   takes to
>>>>>>>>>>>
>>>>>>>>>> require the trip through the Incubator checks as far as the ASF
>>>>>>>>>> guidelines
>>>>>>>>>> are concerned.
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>     From http://incubator.apache.org/ip-clearance/index.html
>>>>>>>>>>
>>>>>>>>>>  """
>>>>>>>>>    From time to time, an external codebase is brought into the ASF
>>>>>>>>>
>>>>>>>> that
>>>>
>>>>> is
>>>>>>>>> not a separate incubating project but still represents a
>>>>>>>>>
>>>>>>>> substantial
>>>
>>>> contribution that was not developed within the ASF's source control
>>>>>>>>> system
>>>>>>>>> and on our public mailing lists.
>>>>>>>>> """
>>>>>>>>>
>>>>>>>>> Not to look a gift-horse in the mouth (it is great work), but I
>>>>>>>>>
>>>>>>>> don't
>>>
>>>> see
>>>>>>>>> these examples as "substantial". I haven't found guidelines yet
>>>>>>>>>
>>>>>>>> that
>>>
>>>> better
>>>>>>>>> clarify the definition of "substantial".
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
Since there's an opinion to create an examples repo instead of keeping 
them in the base project, I'm -0 as long we CI set up so that they don't 
go silently into the night as I previously state as a concern.

Some general questions for actually doing this: do we schedule the move 
of the classes out of the main project for 1.7.0? Will this other repo 
follow the same development practices as the project (e.g. branch 
names). How will we release these examples?

Can someone step up to make sure all of the above are 
completed/addressed and file the necessary INFRA JIRA issues?

David Medinets wrote:
> +1
> On Nov 14, 2014 11:18 AM, "Keith Turner"<ke...@deenlo.com>  wrote:
>
>> On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet<cj...@gmail.com>  wrote:
>>
>>> Josh,
>>>
>>>> My worry with a contrib module is that, historically, code which goes
>>> moves to a contrib is just one step away from the grave.
>>>
>>> You do have a good point. My hope was that this could be the beginning of
>>> our changing history so that we could begin to encourage the community to
>>> contribute their own source directly and give them an outlet for doing
>> so.
>>> I understand that's also the intent of hosting open source repos under
>> ASF
>>> to begin with- so I'm partial to either outcome.
>>>
>>>> I think there's precedence for keeping them in core (as Christopher had
>>> mentioned, next to examples/simple) which would benefit people externally
>>> (more "how do I do X" examples) and internally (keep devs honest about
>> how
>>> our APIs are implemented).
>>>
>>> I would think that would just require keeping the repos up to date as
>>> versions change so they wouldn't get out of date and possibly releasing
>>> them w/ our other releases.
>>>
>>>
>>> Wherever they end up living, thank you Adam for the contributions!
>>>
>> I'll 2nd that.
>>
>> For the following reasons, I think it might be nice to move existing
>> examples out of core into their own git repo(s).
>>
>>   * Examples would be based on released version of Accumulo
>>   * Examples could easily be built w/o building all of Accumulo
>>   * As Sean said, this would keep us honest
>>   * The examples poms would serve as examples more than they do when part of
>> Accumulo build
>>   * Less likely to use non public APIs in examples
>>
>>
>>>
>>>
>>> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser<jo...@gmail.com>
>> wrote:
>>>> My worry with a contrib module is that, historically, code which goes
>>>> moves to a contrib is just one step away from the grave. I think
>> there's
>>>> precedence for keeping them in core (as Christopher had mentioned, next
>>> to
>>>> examples/simple) which would benefit people externally (more "how do I
>> do
>>>> X" examples) and internally (keep devs honest about how our APIs are
>>>> implemented).
>>>>
>>>> Bringing the examples into the core also encourages us to grow the
>>>> community which has been stagnant with respect to new committers for
>>> about
>>>> 9 months now.
>>>>
>>>>
>>>> Corey Nolet wrote:
>>>>
>>>>> +1 for adding the examples to contrib.
>>>>>
>>>>> I was, myself, reading over this email wondering how a set of 11
>>> separate
>>>>> examples on the use of Accumulo would fit into the core codebase-
>>>>> especially as more are contributed over tinme. I like the idea of
>> giving
>>>>> community members an outlet for contributing examples that they've
>> built
>>>>> so
>>>>> that we can continue to foster that without having to fit them in the
>>> core
>>>>> codebase. It just seems more maintainable.
>>>>>
>>>>>
>>>>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
>>> wrote:
>>>>>   I'll take that as you disagree with my consideration of
>> "substantial".
>>>>>> Thanks.
>>>>>>
>>>>>>
>>>>>> Mike Drob wrote:
>>>>>>
>>>>>>   The proposed contribution is a collection of 11 examples. It's
>> clearly
>>>>>>> non-trivial, which is probably enough to be considered "substantial"
>>>>>>>
>>>>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>>>>>> wrote:
>>>>>>>
>>>>>>>
>>>>>>>   Sean Busbey wrote:
>>>>>>>>    On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
>> josh.elser@gmail.com>
>>>>>>>>> wrote:
>>>>>>>>>
>>>>>>>>>     Personally, I didn't really think that this contribution was in
>>> the
>>>>>>>>>   spirit
>>>>>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>>>>>
>>>>>>>>>> Some extra examples which leverage what Accumulo already does
>> seems
>>>>>>>>>> more
>>>>>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>     It's content developed out side of the project list. That's
>> all
>>> it
>>>>>>>>>>   takes to
>>>>>>>>> require the trip through the Incubator checks as far as the ASF
>>>>>>>>> guidelines
>>>>>>>>> are concerned.
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>     From http://incubator.apache.org/ip-clearance/index.html
>>>>>>>>>
>>>>>>>> """
>>>>>>>>    From time to time, an external codebase is brought into the ASF
>>> that
>>>>>>>> is
>>>>>>>> not a separate incubating project but still represents a
>> substantial
>>>>>>>> contribution that was not developed within the ASF's source control
>>>>>>>> system
>>>>>>>> and on our public mailing lists.
>>>>>>>> """
>>>>>>>>
>>>>>>>> Not to look a gift-horse in the mouth (it is great work), but I
>> don't
>>>>>>>> see
>>>>>>>> these examples as "substantial". I haven't found guidelines yet
>> that
>>>>>>>> better
>>>>>>>> clarify the definition of "substantial".
>>>>>>>>
>>>>>>>>
>>>>>>>>
>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
Wasn't the whole discussion about making existing and future examples
contribs? (Which itself implies its own repo)

Did I miss something?
On Nov 14, 2014 10:56 AM, "Mike Drob" <ma...@cloudera.com> wrote:

> I am +1 for setting up a Jenkins Job, which implies a separate repository,
> I think.
>
> On Fri, Nov 14, 2014 at 12:19 PM, Corey Nolet <cj...@gmail.com> wrote:
>
> > Mike & David,
> >
> > Are you +1 for contributing the examples or +1 for moving the examples
> out
> > into separate repos?
> >
> > On Fri, Nov 14, 2014 at 12:52 PM, David Medinets <
> david.medinets@gmail.com
> > >
> > wrote:
> >
> > > +1
> > > On Nov 14, 2014 11:18 AM, "Keith Turner" <ke...@deenlo.com> wrote:
> > >
> > > > On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com>
> > wrote:
> > > >
> > > > > Josh,
> > > > >
> > > > > > My worry with a contrib module is that, historically, code which
> > goes
> > > > > moves to a contrib is just one step away from the grave.
> > > > >
> > > > > You do have a good point. My hope was that this could be the
> > beginning
> > > of
> > > > > our changing history so that we could begin to encourage the
> > community
> > > to
> > > > > contribute their own source directly and give them an outlet for
> > doing
> > > > so.
> > > > > I understand that's also the intent of hosting open source repos
> > under
> > > > ASF
> > > > > to begin with- so I'm partial to either outcome.
> > > > >
> > > > > > I think there's precedence for keeping them in core (as
> Christopher
> > > had
> > > > > mentioned, next to examples/simple) which would benefit people
> > > externally
> > > > > (more "how do I do X" examples) and internally (keep devs honest
> > about
> > > > how
> > > > > our APIs are implemented).
> > > > >
> > > > > I would think that would just require keeping the repos up to date
> as
> > > > > versions change so they wouldn't get out of date and possibly
> > releasing
> > > > > them w/ our other releases.
> > > > >
> > > > >
> > > > > Wherever they end up living, thank you Adam for the contributions!
> > > > >
> > > >
> > > > I'll 2nd that.
> > > >
> > > > For the following reasons, I think it might be nice to move existing
> > > > examples out of core into their own git repo(s).
> > > >
> > > >  * Examples would be based on released version of Accumulo
> > > >  * Examples could easily be built w/o building all of Accumulo
> > > >  * As Sean said, this would keep us honest
> > > >  * The examples poms would serve as examples more than they do when
> > part
> > > of
> > > > Accumulo build
> > > >  * Less likely to use non public APIs in examples
> > > >
> > > >
> > > > >
> > > > >
> > > > >
> > > > > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> > > > wrote:
> > > > >
> > > > > > My worry with a contrib module is that, historically, code which
> > goes
> > > > > > moves to a contrib is just one step away from the grave. I think
> > > > there's
> > > > > > precedence for keeping them in core (as Christopher had
> mentioned,
> > > next
> > > > > to
> > > > > > examples/simple) which would benefit people externally (more "how
> > do
> > > I
> > > > do
> > > > > > X" examples) and internally (keep devs honest about how our APIs
> > are
> > > > > > implemented).
> > > > > >
> > > > > > Bringing the examples into the core also encourages us to grow
> the
> > > > > > community which has been stagnant with respect to new committers
> > for
> > > > > about
> > > > > > 9 months now.
> > > > > >
> > > > > >
> > > > > > Corey Nolet wrote:
> > > > > >
> > > > > >> +1 for adding the examples to contrib.
> > > > > >>
> > > > > >> I was, myself, reading over this email wondering how a set of 11
> > > > > separate
> > > > > >> examples on the use of Accumulo would fit into the core
> codebase-
> > > > > >> especially as more are contributed over tinme. I like the idea
> of
> > > > giving
> > > > > >> community members an outlet for contributing examples that
> they've
> > > > built
> > > > > >> so
> > > > > >> that we can continue to foster that without having to fit them
> in
> > > the
> > > > > core
> > > > > >> codebase. It just seems more maintainable.
> > > > > >>
> > > > > >>
> > > > > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<
> josh.elser@gmail.com>
> > > > > wrote:
> > > > > >>
> > > > > >>  I'll take that as you disagree with my consideration of
> > > > "substantial".
> > > > > >>> Thanks.
> > > > > >>>
> > > > > >>>
> > > > > >>> Mike Drob wrote:
> > > > > >>>
> > > > > >>>  The proposed contribution is a collection of 11 examples. It's
> > > > clearly
> > > > > >>>> non-trivial, which is probably enough to be considered
> > > "substantial"
> > > > > >>>>
> > > > > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<
> > josh.elser@gmail.com
> > > >
> > > > > >>>> wrote:
> > > > > >>>>
> > > > > >>>>
> > > > > >>>>  Sean Busbey wrote:
> > > > > >>>>>
> > > > > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> > > > josh.elser@gmail.com>
> > > > > >>>>>
> > > > > >>>>>> wrote:
> > > > > >>>>>>
> > > > > >>>>>>    Personally, I didn't really think that this contribution
> > was
> > > in
> > > > > the
> > > > > >>>>>>
> > > > > >>>>>>  spirit
> > > > > >>>>>>> of what the new codebase adoption guidelines were meant to
> > > cover.
> > > > > >>>>>>>
> > > > > >>>>>>> Some extra examples which leverage what Accumulo already
> does
> > > > seems
> > > > > >>>>>>> more
> > > > > >>>>>>> like improvements for new Accumulo users than anything
> else.
> > > > > >>>>>>>
> > > > > >>>>>>>
> > > > > >>>>>>>    It's content developed out side of the project list.
> > That's
> > > > all
> > > > > it
> > > > > >>>>>>>
> > > > > >>>>>>>  takes to
> > > > > >>>>>> require the trip through the Incubator checks as far as the
> > ASF
> > > > > >>>>>> guidelines
> > > > > >>>>>> are concerned.
> > > > > >>>>>>
> > > > > >>>>>>
> > > > > >>>>>>
> > > > > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > > > > >>>>>>
> > > > > >>>>> """
> > > > > >>>>>   From time to time, an external codebase is brought into the
> > ASF
> > > > > that
> > > > > >>>>> is
> > > > > >>>>> not a separate incubating project but still represents a
> > > > substantial
> > > > > >>>>> contribution that was not developed within the ASF's source
> > > control
> > > > > >>>>> system
> > > > > >>>>> and on our public mailing lists.
> > > > > >>>>> """
> > > > > >>>>>
> > > > > >>>>> Not to look a gift-horse in the mouth (it is great work),
> but I
> > > > don't
> > > > > >>>>> see
> > > > > >>>>> these examples as "substantial". I haven't found guidelines
> yet
> > > > that
> > > > > >>>>> better
> > > > > >>>>> clarify the definition of "substantial".
> > > > > >>>>>
> > > > > >>>>>
> > > > > >>>>>
> > > > > >>
> > > > >
> > > >
> > >
> >
>

Re: Contribute Examples/Exercises

Posted by Mike Drob <ma...@cloudera.com>.
I am +1 for setting up a Jenkins Job, which implies a separate repository,
I think.

On Fri, Nov 14, 2014 at 12:19 PM, Corey Nolet <cj...@gmail.com> wrote:

> Mike & David,
>
> Are you +1 for contributing the examples or +1 for moving the examples out
> into separate repos?
>
> On Fri, Nov 14, 2014 at 12:52 PM, David Medinets <david.medinets@gmail.com
> >
> wrote:
>
> > +1
> > On Nov 14, 2014 11:18 AM, "Keith Turner" <ke...@deenlo.com> wrote:
> >
> > > On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com>
> wrote:
> > >
> > > > Josh,
> > > >
> > > > > My worry with a contrib module is that, historically, code which
> goes
> > > > moves to a contrib is just one step away from the grave.
> > > >
> > > > You do have a good point. My hope was that this could be the
> beginning
> > of
> > > > our changing history so that we could begin to encourage the
> community
> > to
> > > > contribute their own source directly and give them an outlet for
> doing
> > > so.
> > > > I understand that's also the intent of hosting open source repos
> under
> > > ASF
> > > > to begin with- so I'm partial to either outcome.
> > > >
> > > > > I think there's precedence for keeping them in core (as Christopher
> > had
> > > > mentioned, next to examples/simple) which would benefit people
> > externally
> > > > (more "how do I do X" examples) and internally (keep devs honest
> about
> > > how
> > > > our APIs are implemented).
> > > >
> > > > I would think that would just require keeping the repos up to date as
> > > > versions change so they wouldn't get out of date and possibly
> releasing
> > > > them w/ our other releases.
> > > >
> > > >
> > > > Wherever they end up living, thank you Adam for the contributions!
> > > >
> > >
> > > I'll 2nd that.
> > >
> > > For the following reasons, I think it might be nice to move existing
> > > examples out of core into their own git repo(s).
> > >
> > >  * Examples would be based on released version of Accumulo
> > >  * Examples could easily be built w/o building all of Accumulo
> > >  * As Sean said, this would keep us honest
> > >  * The examples poms would serve as examples more than they do when
> part
> > of
> > > Accumulo build
> > >  * Less likely to use non public APIs in examples
> > >
> > >
> > > >
> > > >
> > > >
> > > > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> > > wrote:
> > > >
> > > > > My worry with a contrib module is that, historically, code which
> goes
> > > > > moves to a contrib is just one step away from the grave. I think
> > > there's
> > > > > precedence for keeping them in core (as Christopher had mentioned,
> > next
> > > > to
> > > > > examples/simple) which would benefit people externally (more "how
> do
> > I
> > > do
> > > > > X" examples) and internally (keep devs honest about how our APIs
> are
> > > > > implemented).
> > > > >
> > > > > Bringing the examples into the core also encourages us to grow the
> > > > > community which has been stagnant with respect to new committers
> for
> > > > about
> > > > > 9 months now.
> > > > >
> > > > >
> > > > > Corey Nolet wrote:
> > > > >
> > > > >> +1 for adding the examples to contrib.
> > > > >>
> > > > >> I was, myself, reading over this email wondering how a set of 11
> > > > separate
> > > > >> examples on the use of Accumulo would fit into the core codebase-
> > > > >> especially as more are contributed over tinme. I like the idea of
> > > giving
> > > > >> community members an outlet for contributing examples that they've
> > > built
> > > > >> so
> > > > >> that we can continue to foster that without having to fit them in
> > the
> > > > core
> > > > >> codebase. It just seems more maintainable.
> > > > >>
> > > > >>
> > > > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > > > wrote:
> > > > >>
> > > > >>  I'll take that as you disagree with my consideration of
> > > "substantial".
> > > > >>> Thanks.
> > > > >>>
> > > > >>>
> > > > >>> Mike Drob wrote:
> > > > >>>
> > > > >>>  The proposed contribution is a collection of 11 examples. It's
> > > clearly
> > > > >>>> non-trivial, which is probably enough to be considered
> > "substantial"
> > > > >>>>
> > > > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<
> josh.elser@gmail.com
> > >
> > > > >>>> wrote:
> > > > >>>>
> > > > >>>>
> > > > >>>>  Sean Busbey wrote:
> > > > >>>>>
> > > > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> > > josh.elser@gmail.com>
> > > > >>>>>
> > > > >>>>>> wrote:
> > > > >>>>>>
> > > > >>>>>>    Personally, I didn't really think that this contribution
> was
> > in
> > > > the
> > > > >>>>>>
> > > > >>>>>>  spirit
> > > > >>>>>>> of what the new codebase adoption guidelines were meant to
> > cover.
> > > > >>>>>>>
> > > > >>>>>>> Some extra examples which leverage what Accumulo already does
> > > seems
> > > > >>>>>>> more
> > > > >>>>>>> like improvements for new Accumulo users than anything else.
> > > > >>>>>>>
> > > > >>>>>>>
> > > > >>>>>>>    It's content developed out side of the project list.
> That's
> > > all
> > > > it
> > > > >>>>>>>
> > > > >>>>>>>  takes to
> > > > >>>>>> require the trip through the Incubator checks as far as the
> ASF
> > > > >>>>>> guidelines
> > > > >>>>>> are concerned.
> > > > >>>>>>
> > > > >>>>>>
> > > > >>>>>>
> > > > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > > > >>>>>>
> > > > >>>>> """
> > > > >>>>>   From time to time, an external codebase is brought into the
> ASF
> > > > that
> > > > >>>>> is
> > > > >>>>> not a separate incubating project but still represents a
> > > substantial
> > > > >>>>> contribution that was not developed within the ASF's source
> > control
> > > > >>>>> system
> > > > >>>>> and on our public mailing lists.
> > > > >>>>> """
> > > > >>>>>
> > > > >>>>> Not to look a gift-horse in the mouth (it is great work), but I
> > > don't
> > > > >>>>> see
> > > > >>>>> these examples as "substantial". I haven't found guidelines yet
> > > that
> > > > >>>>> better
> > > > >>>>> clarify the definition of "substantial".
> > > > >>>>>
> > > > >>>>>
> > > > >>>>>
> > > > >>
> > > >
> > >
> >
>

Re: Contribute Examples/Exercises

Posted by Corey Nolet <cj...@gmail.com>.
Mike & David,

Are you +1 for contributing the examples or +1 for moving the examples out
into separate repos?

On Fri, Nov 14, 2014 at 12:52 PM, David Medinets <da...@gmail.com>
wrote:

> +1
> On Nov 14, 2014 11:18 AM, "Keith Turner" <ke...@deenlo.com> wrote:
>
> > On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com> wrote:
> >
> > > Josh,
> > >
> > > > My worry with a contrib module is that, historically, code which goes
> > > moves to a contrib is just one step away from the grave.
> > >
> > > You do have a good point. My hope was that this could be the beginning
> of
> > > our changing history so that we could begin to encourage the community
> to
> > > contribute their own source directly and give them an outlet for doing
> > so.
> > > I understand that's also the intent of hosting open source repos under
> > ASF
> > > to begin with- so I'm partial to either outcome.
> > >
> > > > I think there's precedence for keeping them in core (as Christopher
> had
> > > mentioned, next to examples/simple) which would benefit people
> externally
> > > (more "how do I do X" examples) and internally (keep devs honest about
> > how
> > > our APIs are implemented).
> > >
> > > I would think that would just require keeping the repos up to date as
> > > versions change so they wouldn't get out of date and possibly releasing
> > > them w/ our other releases.
> > >
> > >
> > > Wherever they end up living, thank you Adam for the contributions!
> > >
> >
> > I'll 2nd that.
> >
> > For the following reasons, I think it might be nice to move existing
> > examples out of core into their own git repo(s).
> >
> >  * Examples would be based on released version of Accumulo
> >  * Examples could easily be built w/o building all of Accumulo
> >  * As Sean said, this would keep us honest
> >  * The examples poms would serve as examples more than they do when part
> of
> > Accumulo build
> >  * Less likely to use non public APIs in examples
> >
> >
> > >
> > >
> > >
> > > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> > wrote:
> > >
> > > > My worry with a contrib module is that, historically, code which goes
> > > > moves to a contrib is just one step away from the grave. I think
> > there's
> > > > precedence for keeping them in core (as Christopher had mentioned,
> next
> > > to
> > > > examples/simple) which would benefit people externally (more "how do
> I
> > do
> > > > X" examples) and internally (keep devs honest about how our APIs are
> > > > implemented).
> > > >
> > > > Bringing the examples into the core also encourages us to grow the
> > > > community which has been stagnant with respect to new committers for
> > > about
> > > > 9 months now.
> > > >
> > > >
> > > > Corey Nolet wrote:
> > > >
> > > >> +1 for adding the examples to contrib.
> > > >>
> > > >> I was, myself, reading over this email wondering how a set of 11
> > > separate
> > > >> examples on the use of Accumulo would fit into the core codebase-
> > > >> especially as more are contributed over tinme. I like the idea of
> > giving
> > > >> community members an outlet for contributing examples that they've
> > built
> > > >> so
> > > >> that we can continue to foster that without having to fit them in
> the
> > > core
> > > >> codebase. It just seems more maintainable.
> > > >>
> > > >>
> > > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > > wrote:
> > > >>
> > > >>  I'll take that as you disagree with my consideration of
> > "substantial".
> > > >>> Thanks.
> > > >>>
> > > >>>
> > > >>> Mike Drob wrote:
> > > >>>
> > > >>>  The proposed contribution is a collection of 11 examples. It's
> > clearly
> > > >>>> non-trivial, which is probably enough to be considered
> "substantial"
> > > >>>>
> > > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<josh.elser@gmail.com
> >
> > > >>>> wrote:
> > > >>>>
> > > >>>>
> > > >>>>  Sean Busbey wrote:
> > > >>>>>
> > > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> > josh.elser@gmail.com>
> > > >>>>>
> > > >>>>>> wrote:
> > > >>>>>>
> > > >>>>>>    Personally, I didn't really think that this contribution was
> in
> > > the
> > > >>>>>>
> > > >>>>>>  spirit
> > > >>>>>>> of what the new codebase adoption guidelines were meant to
> cover.
> > > >>>>>>>
> > > >>>>>>> Some extra examples which leverage what Accumulo already does
> > seems
> > > >>>>>>> more
> > > >>>>>>> like improvements for new Accumulo users than anything else.
> > > >>>>>>>
> > > >>>>>>>
> > > >>>>>>>    It's content developed out side of the project list. That's
> > all
> > > it
> > > >>>>>>>
> > > >>>>>>>  takes to
> > > >>>>>> require the trip through the Incubator checks as far as the ASF
> > > >>>>>> guidelines
> > > >>>>>> are concerned.
> > > >>>>>>
> > > >>>>>>
> > > >>>>>>
> > > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > > >>>>>>
> > > >>>>> """
> > > >>>>>   From time to time, an external codebase is brought into the ASF
> > > that
> > > >>>>> is
> > > >>>>> not a separate incubating project but still represents a
> > substantial
> > > >>>>> contribution that was not developed within the ASF's source
> control
> > > >>>>> system
> > > >>>>> and on our public mailing lists.
> > > >>>>> """
> > > >>>>>
> > > >>>>> Not to look a gift-horse in the mouth (it is great work), but I
> > don't
> > > >>>>> see
> > > >>>>> these examples as "substantial". I haven't found guidelines yet
> > that
> > > >>>>> better
> > > >>>>> clarify the definition of "substantial".
> > > >>>>>
> > > >>>>>
> > > >>>>>
> > > >>
> > >
> >
>

Re: Contribute Examples/Exercises

Posted by David Medinets <da...@gmail.com>.
+1
On Nov 14, 2014 11:18 AM, "Keith Turner" <ke...@deenlo.com> wrote:

> On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com> wrote:
>
> > Josh,
> >
> > > My worry with a contrib module is that, historically, code which goes
> > moves to a contrib is just one step away from the grave.
> >
> > You do have a good point. My hope was that this could be the beginning of
> > our changing history so that we could begin to encourage the community to
> > contribute their own source directly and give them an outlet for doing
> so.
> > I understand that's also the intent of hosting open source repos under
> ASF
> > to begin with- so I'm partial to either outcome.
> >
> > > I think there's precedence for keeping them in core (as Christopher had
> > mentioned, next to examples/simple) which would benefit people externally
> > (more "how do I do X" examples) and internally (keep devs honest about
> how
> > our APIs are implemented).
> >
> > I would think that would just require keeping the repos up to date as
> > versions change so they wouldn't get out of date and possibly releasing
> > them w/ our other releases.
> >
> >
> > Wherever they end up living, thank you Adam for the contributions!
> >
>
> I'll 2nd that.
>
> For the following reasons, I think it might be nice to move existing
> examples out of core into their own git repo(s).
>
>  * Examples would be based on released version of Accumulo
>  * Examples could easily be built w/o building all of Accumulo
>  * As Sean said, this would keep us honest
>  * The examples poms would serve as examples more than they do when part of
> Accumulo build
>  * Less likely to use non public APIs in examples
>
>
> >
> >
> >
> > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> wrote:
> >
> > > My worry with a contrib module is that, historically, code which goes
> > > moves to a contrib is just one step away from the grave. I think
> there's
> > > precedence for keeping them in core (as Christopher had mentioned, next
> > to
> > > examples/simple) which would benefit people externally (more "how do I
> do
> > > X" examples) and internally (keep devs honest about how our APIs are
> > > implemented).
> > >
> > > Bringing the examples into the core also encourages us to grow the
> > > community which has been stagnant with respect to new committers for
> > about
> > > 9 months now.
> > >
> > >
> > > Corey Nolet wrote:
> > >
> > >> +1 for adding the examples to contrib.
> > >>
> > >> I was, myself, reading over this email wondering how a set of 11
> > separate
> > >> examples on the use of Accumulo would fit into the core codebase-
> > >> especially as more are contributed over tinme. I like the idea of
> giving
> > >> community members an outlet for contributing examples that they've
> built
> > >> so
> > >> that we can continue to foster that without having to fit them in the
> > core
> > >> codebase. It just seems more maintainable.
> > >>
> > >>
> > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > wrote:
> > >>
> > >>  I'll take that as you disagree with my consideration of
> "substantial".
> > >>> Thanks.
> > >>>
> > >>>
> > >>> Mike Drob wrote:
> > >>>
> > >>>  The proposed contribution is a collection of 11 examples. It's
> clearly
> > >>>> non-trivial, which is probably enough to be considered "substantial"
> > >>>>
> > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
> > >>>> wrote:
> > >>>>
> > >>>>
> > >>>>  Sean Busbey wrote:
> > >>>>>
> > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> josh.elser@gmail.com>
> > >>>>>
> > >>>>>> wrote:
> > >>>>>>
> > >>>>>>    Personally, I didn't really think that this contribution was in
> > the
> > >>>>>>
> > >>>>>>  spirit
> > >>>>>>> of what the new codebase adoption guidelines were meant to cover.
> > >>>>>>>
> > >>>>>>> Some extra examples which leverage what Accumulo already does
> seems
> > >>>>>>> more
> > >>>>>>> like improvements for new Accumulo users than anything else.
> > >>>>>>>
> > >>>>>>>
> > >>>>>>>    It's content developed out side of the project list. That's
> all
> > it
> > >>>>>>>
> > >>>>>>>  takes to
> > >>>>>> require the trip through the Incubator checks as far as the ASF
> > >>>>>> guidelines
> > >>>>>> are concerned.
> > >>>>>>
> > >>>>>>
> > >>>>>>
> > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > >>>>>>
> > >>>>> """
> > >>>>>   From time to time, an external codebase is brought into the ASF
> > that
> > >>>>> is
> > >>>>> not a separate incubating project but still represents a
> substantial
> > >>>>> contribution that was not developed within the ASF's source control
> > >>>>> system
> > >>>>> and on our public mailing lists.
> > >>>>> """
> > >>>>>
> > >>>>> Not to look a gift-horse in the mouth (it is great work), but I
> don't
> > >>>>> see
> > >>>>> these examples as "substantial". I haven't found guidelines yet
> that
> > >>>>> better
> > >>>>> clarify the definition of "substantial".
> > >>>>>
> > >>>>>
> > >>>>>
> > >>
> >
>

Re: Contribute Examples/Exercises

Posted by Mike Drob <md...@apache.org>.
+1

On Fri, Nov 14, 2014 at 10:16 AM, Keith Turner <ke...@deenlo.com> wrote:

> On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com> wrote:
>
> > Josh,
> >
> > > My worry with a contrib module is that, historically, code which goes
> > moves to a contrib is just one step away from the grave.
> >
> > You do have a good point. My hope was that this could be the beginning of
> > our changing history so that we could begin to encourage the community to
> > contribute their own source directly and give them an outlet for doing
> so.
> > I understand that's also the intent of hosting open source repos under
> ASF
> > to begin with- so I'm partial to either outcome.
> >
> > > I think there's precedence for keeping them in core (as Christopher had
> > mentioned, next to examples/simple) which would benefit people externally
> > (more "how do I do X" examples) and internally (keep devs honest about
> how
> > our APIs are implemented).
> >
> > I would think that would just require keeping the repos up to date as
> > versions change so they wouldn't get out of date and possibly releasing
> > them w/ our other releases.
> >
> >
> > Wherever they end up living, thank you Adam for the contributions!
> >
>
> I'll 2nd that.
>
> For the following reasons, I think it might be nice to move existing
> examples out of core into their own git repo(s).
>
>  * Examples would be based on released version of Accumulo
>  * Examples could easily be built w/o building all of Accumulo
>  * As Sean said, this would keep us honest
>  * The examples poms would serve as examples more than they do when part of
> Accumulo build
>  * Less likely to use non public APIs in examples
>
>
> >
> >
> >
> > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> wrote:
> >
> > > My worry with a contrib module is that, historically, code which goes
> > > moves to a contrib is just one step away from the grave. I think
> there's
> > > precedence for keeping them in core (as Christopher had mentioned, next
> > to
> > > examples/simple) which would benefit people externally (more "how do I
> do
> > > X" examples) and internally (keep devs honest about how our APIs are
> > > implemented).
> > >
> > > Bringing the examples into the core also encourages us to grow the
> > > community which has been stagnant with respect to new committers for
> > about
> > > 9 months now.
> > >
> > >
> > > Corey Nolet wrote:
> > >
> > >> +1 for adding the examples to contrib.
> > >>
> > >> I was, myself, reading over this email wondering how a set of 11
> > separate
> > >> examples on the use of Accumulo would fit into the core codebase-
> > >> especially as more are contributed over tinme. I like the idea of
> giving
> > >> community members an outlet for contributing examples that they've
> built
> > >> so
> > >> that we can continue to foster that without having to fit them in the
> > core
> > >> codebase. It just seems more maintainable.
> > >>
> > >>
> > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > wrote:
> > >>
> > >>  I'll take that as you disagree with my consideration of
> "substantial".
> > >>> Thanks.
> > >>>
> > >>>
> > >>> Mike Drob wrote:
> > >>>
> > >>>  The proposed contribution is a collection of 11 examples. It's
> clearly
> > >>>> non-trivial, which is probably enough to be considered "substantial"
> > >>>>
> > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
> > >>>> wrote:
> > >>>>
> > >>>>
> > >>>>  Sean Busbey wrote:
> > >>>>>
> > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> josh.elser@gmail.com>
> > >>>>>
> > >>>>>> wrote:
> > >>>>>>
> > >>>>>>    Personally, I didn't really think that this contribution was in
> > the
> > >>>>>>
> > >>>>>>  spirit
> > >>>>>>> of what the new codebase adoption guidelines were meant to cover.
> > >>>>>>>
> > >>>>>>> Some extra examples which leverage what Accumulo already does
> seems
> > >>>>>>> more
> > >>>>>>> like improvements for new Accumulo users than anything else.
> > >>>>>>>
> > >>>>>>>
> > >>>>>>>    It's content developed out side of the project list. That's
> all
> > it
> > >>>>>>>
> > >>>>>>>  takes to
> > >>>>>> require the trip through the Incubator checks as far as the ASF
> > >>>>>> guidelines
> > >>>>>> are concerned.
> > >>>>>>
> > >>>>>>
> > >>>>>>
> > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > >>>>>>
> > >>>>> """
> > >>>>>   From time to time, an external codebase is brought into the ASF
> > that
> > >>>>> is
> > >>>>> not a separate incubating project but still represents a
> substantial
> > >>>>> contribution that was not developed within the ASF's source control
> > >>>>> system
> > >>>>> and on our public mailing lists.
> > >>>>> """
> > >>>>>
> > >>>>> Not to look a gift-horse in the mouth (it is great work), but I
> don't
> > >>>>> see
> > >>>>> these examples as "substantial". I haven't found guidelines yet
> that
> > >>>>> better
> > >>>>> clarify the definition of "substantial".
> > >>>>>
> > >>>>>
> > >>>>>
> > >>
> >
>

Re: Contribute Examples/Exercises

Posted by Christopher <ct...@apache.org>.
On Fri, Nov 14, 2014 at 11:16 AM, Keith Turner <ke...@deenlo.com> wrote:

> On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com> wrote:
>
> > Josh,
> >
> > > My worry with a contrib module is that, historically, code which goes
> > moves to a contrib is just one step away from the grave.
> >
> > You do have a good point. My hope was that this could be the beginning of
> > our changing history so that we could begin to encourage the community to
> > contribute their own source directly and give them an outlet for doing
> so.
> > I understand that's also the intent of hosting open source repos under
> ASF
> > to begin with- so I'm partial to either outcome.
> >
> > > I think there's precedence for keeping them in core (as Christopher had
> > mentioned, next to examples/simple) which would benefit people externally
> > (more "how do I do X" examples) and internally (keep devs honest about
> how
> > our APIs are implemented).
> >
> > I would think that would just require keeping the repos up to date as
> > versions change so they wouldn't get out of date and possibly releasing
> > them w/ our other releases.
> >
> >
> > Wherever they end up living, thank you Adam for the contributions!
> >
>
> I'll 2nd that.
>
>
+1


> For the following reasons, I think it might be nice to move existing
> examples out of core into their own git repo(s).
>
>  * Examples would be based on released version of Accumulo
>  * Examples could easily be built w/o building all of Accumulo
>  * As Sean said, this would keep us honest
>  * The examples poms would serve as examples more than they do when part of
> Accumulo build
>  * Less likely to use non public APIs in examples
>
>
I don't know that a separate repo is a prerequisite for these goals. For
instance, if we had a client API jar (which we will for 2.0.0), we can have
a compile dependency on that within the examples, and only runtime-scoped
dependencies for the remaining Accumulo artifacts, in order to guarantee
we're not using non-public APIs.

I do think a lot of these goals makes sense in the context of a stable API
with version guarantees (2.0.0 and later). As a separate repo, they can
still be used in the automated build to ensure we haven't introduced
breaking changes within a version, but it would add significant extra
effort (of the chicken/egg variety) for each major release. As part of the
core repo, and with some care, it wouldn't be too hard to restrict builds
of the examples module to only major (*.0.0) releases, and it can even have
a separate versioning scheme (that does not inherit from the Accumulo
parent pom.xml). Before examples are moved to a separate repo, we're going
to have to address these issues. This discussion could be deferred to when
we are closer to considering a 2.0.0 release.


>
> >
> >
> >
> > On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com>
> wrote:
> >
> > > My worry with a contrib module is that, historically, code which goes
> > > moves to a contrib is just one step away from the grave. I think
> there's
> > > precedence for keeping them in core (as Christopher had mentioned, next
> > to
> > > examples/simple) which would benefit people externally (more "how do I
> do
> > > X" examples) and internally (keep devs honest about how our APIs are
> > > implemented).
> > >
> > > Bringing the examples into the core also encourages us to grow the
> > > community which has been stagnant with respect to new committers for
> > about
> > > 9 months now.
> > >
> > >
> > > Corey Nolet wrote:
> > >
> > >> +1 for adding the examples to contrib.
> > >>
> > >> I was, myself, reading over this email wondering how a set of 11
> > separate
> > >> examples on the use of Accumulo would fit into the core codebase-
> > >> especially as more are contributed over tinme. I like the idea of
> giving
> > >> community members an outlet for contributing examples that they've
> built
> > >> so
> > >> that we can continue to foster that without having to fit them in the
> > core
> > >> codebase. It just seems more maintainable.
> > >>
> > >>
> > >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> > wrote:
> > >>
> > >>  I'll take that as you disagree with my consideration of
> "substantial".
> > >>> Thanks.
> > >>>
> > >>>
> > >>> Mike Drob wrote:
> > >>>
> > >>>  The proposed contribution is a collection of 11 examples. It's
> clearly
> > >>>> non-trivial, which is probably enough to be considered "substantial"
> > >>>>
> > >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
> > >>>> wrote:
> > >>>>
> > >>>>
> > >>>>  Sean Busbey wrote:
> > >>>>>
> > >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<
> josh.elser@gmail.com>
> > >>>>>
> > >>>>>> wrote:
> > >>>>>>
> > >>>>>>    Personally, I didn't really think that this contribution was in
> > the
> > >>>>>>
> > >>>>>>  spirit
> > >>>>>>> of what the new codebase adoption guidelines were meant to cover.
> > >>>>>>>
> > >>>>>>> Some extra examples which leverage what Accumulo already does
> seems
> > >>>>>>> more
> > >>>>>>> like improvements for new Accumulo users than anything else.
> > >>>>>>>
> > >>>>>>>
> > >>>>>>>    It's content developed out side of the project list. That's
> all
> > it
> > >>>>>>>
> > >>>>>>>  takes to
> > >>>>>> require the trip through the Incubator checks as far as the ASF
> > >>>>>> guidelines
> > >>>>>> are concerned.
> > >>>>>>
> > >>>>>>
> > >>>>>>
> > >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> > >>>>>>
> > >>>>> """
> > >>>>>   From time to time, an external codebase is brought into the ASF
> > that
> > >>>>> is
> > >>>>> not a separate incubating project but still represents a
> substantial
> > >>>>> contribution that was not developed within the ASF's source control
> > >>>>> system
> > >>>>> and on our public mailing lists.
> > >>>>> """
> > >>>>>
> > >>>>> Not to look a gift-horse in the mouth (it is great work), but I
> don't
> > >>>>> see
> > >>>>> these examples as "substantial". I haven't found guidelines yet
> that
> > >>>>> better
> > >>>>> clarify the definition of "substantial".
> > >>>>>
> > >>>>>
> > >>>>>
> > >>
> >
>

Re: Contribute Examples/Exercises

Posted by Keith Turner <ke...@deenlo.com>.
On Wed, Nov 12, 2014 at 4:52 PM, Corey Nolet <cj...@gmail.com> wrote:

> Josh,
>
> > My worry with a contrib module is that, historically, code which goes
> moves to a contrib is just one step away from the grave.
>
> You do have a good point. My hope was that this could be the beginning of
> our changing history so that we could begin to encourage the community to
> contribute their own source directly and give them an outlet for doing so.
> I understand that's also the intent of hosting open source repos under ASF
> to begin with- so I'm partial to either outcome.
>
> > I think there's precedence for keeping them in core (as Christopher had
> mentioned, next to examples/simple) which would benefit people externally
> (more "how do I do X" examples) and internally (keep devs honest about how
> our APIs are implemented).
>
> I would think that would just require keeping the repos up to date as
> versions change so they wouldn't get out of date and possibly releasing
> them w/ our other releases.
>
>
> Wherever they end up living, thank you Adam for the contributions!
>

I'll 2nd that.

For the following reasons, I think it might be nice to move existing
examples out of core into their own git repo(s).

 * Examples would be based on released version of Accumulo
 * Examples could easily be built w/o building all of Accumulo
 * As Sean said, this would keep us honest
 * The examples poms would serve as examples more than they do when part of
Accumulo build
 * Less likely to use non public APIs in examples


>
>
>
> On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com> wrote:
>
> > My worry with a contrib module is that, historically, code which goes
> > moves to a contrib is just one step away from the grave. I think there's
> > precedence for keeping them in core (as Christopher had mentioned, next
> to
> > examples/simple) which would benefit people externally (more "how do I do
> > X" examples) and internally (keep devs honest about how our APIs are
> > implemented).
> >
> > Bringing the examples into the core also encourages us to grow the
> > community which has been stagnant with respect to new committers for
> about
> > 9 months now.
> >
> >
> > Corey Nolet wrote:
> >
> >> +1 for adding the examples to contrib.
> >>
> >> I was, myself, reading over this email wondering how a set of 11
> separate
> >> examples on the use of Accumulo would fit into the core codebase-
> >> especially as more are contributed over tinme. I like the idea of giving
> >> community members an outlet for contributing examples that they've built
> >> so
> >> that we can continue to foster that without having to fit them in the
> core
> >> codebase. It just seems more maintainable.
> >>
> >>
> >> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>
> wrote:
> >>
> >>  I'll take that as you disagree with my consideration of "substantial".
> >>> Thanks.
> >>>
> >>>
> >>> Mike Drob wrote:
> >>>
> >>>  The proposed contribution is a collection of 11 examples. It's clearly
> >>>> non-trivial, which is probably enough to be considered "substantial"
> >>>>
> >>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
> >>>> wrote:
> >>>>
> >>>>
> >>>>  Sean Busbey wrote:
> >>>>>
> >>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
> >>>>>
> >>>>>> wrote:
> >>>>>>
> >>>>>>    Personally, I didn't really think that this contribution was in
> the
> >>>>>>
> >>>>>>  spirit
> >>>>>>> of what the new codebase adoption guidelines were meant to cover.
> >>>>>>>
> >>>>>>> Some extra examples which leverage what Accumulo already does seems
> >>>>>>> more
> >>>>>>> like improvements for new Accumulo users than anything else.
> >>>>>>>
> >>>>>>>
> >>>>>>>    It's content developed out side of the project list. That's all
> it
> >>>>>>>
> >>>>>>>  takes to
> >>>>>> require the trip through the Incubator checks as far as the ASF
> >>>>>> guidelines
> >>>>>> are concerned.
> >>>>>>
> >>>>>>
> >>>>>>
> >>>>>>    From http://incubator.apache.org/ip-clearance/index.html
> >>>>>>
> >>>>> """
> >>>>>   From time to time, an external codebase is brought into the ASF
> that
> >>>>> is
> >>>>> not a separate incubating project but still represents a substantial
> >>>>> contribution that was not developed within the ASF's source control
> >>>>> system
> >>>>> and on our public mailing lists.
> >>>>> """
> >>>>>
> >>>>> Not to look a gift-horse in the mouth (it is great work), but I don't
> >>>>> see
> >>>>> these examples as "substantial". I haven't found guidelines yet that
> >>>>> better
> >>>>> clarify the definition of "substantial".
> >>>>>
> >>>>>
> >>>>>
> >>
>

Re: Contribute Examples/Exercises

Posted by Corey Nolet <cj...@gmail.com>.
Josh,

> My worry with a contrib module is that, historically, code which goes
moves to a contrib is just one step away from the grave.

You do have a good point. My hope was that this could be the beginning of
our changing history so that we could begin to encourage the community to
contribute their own source directly and give them an outlet for doing so.
I understand that's also the intent of hosting open source repos under ASF
to begin with- so I'm partial to either outcome.

> I think there's precedence for keeping them in core (as Christopher had
mentioned, next to examples/simple) which would benefit people externally
(more "how do I do X" examples) and internally (keep devs honest about how
our APIs are implemented).

I would think that would just require keeping the repos up to date as
versions change so they wouldn't get out of date and possibly releasing
them w/ our other releases.


Wherever they end up living, thank you Adam for the contributions!



On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com> wrote:

> My worry with a contrib module is that, historically, code which goes
> moves to a contrib is just one step away from the grave. I think there's
> precedence for keeping them in core (as Christopher had mentioned, next to
> examples/simple) which would benefit people externally (more "how do I do
> X" examples) and internally (keep devs honest about how our APIs are
> implemented).
>
> Bringing the examples into the core also encourages us to grow the
> community which has been stagnant with respect to new committers for about
> 9 months now.
>
>
> Corey Nolet wrote:
>
>> +1 for adding the examples to contrib.
>>
>> I was, myself, reading over this email wondering how a set of 11 separate
>> examples on the use of Accumulo would fit into the core codebase-
>> especially as more are contributed over tinme. I like the idea of giving
>> community members an outlet for contributing examples that they've built
>> so
>> that we can continue to foster that without having to fit them in the core
>> codebase. It just seems more maintainable.
>>
>>
>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>  wrote:
>>
>>  I'll take that as you disagree with my consideration of "substantial".
>>> Thanks.
>>>
>>>
>>> Mike Drob wrote:
>>>
>>>  The proposed contribution is a collection of 11 examples. It's clearly
>>>> non-trivial, which is probably enough to be considered "substantial"
>>>>
>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>>> wrote:
>>>>
>>>>
>>>>  Sean Busbey wrote:
>>>>>
>>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>>>>>
>>>>>> wrote:
>>>>>>
>>>>>>    Personally, I didn't really think that this contribution was in the
>>>>>>
>>>>>>  spirit
>>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>>
>>>>>>> Some extra examples which leverage what Accumulo already does seems
>>>>>>> more
>>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>>
>>>>>>>
>>>>>>>    It's content developed out side of the project list. That's all it
>>>>>>>
>>>>>>>  takes to
>>>>>> require the trip through the Incubator checks as far as the ASF
>>>>>> guidelines
>>>>>> are concerned.
>>>>>>
>>>>>>
>>>>>>
>>>>>>    From http://incubator.apache.org/ip-clearance/index.html
>>>>>>
>>>>> """
>>>>>   From time to time, an external codebase is brought into the ASF that
>>>>> is
>>>>> not a separate incubating project but still represents a substantial
>>>>> contribution that was not developed within the ASF's source control
>>>>> system
>>>>> and on our public mailing lists.
>>>>> """
>>>>>
>>>>> Not to look a gift-horse in the mouth (it is great work), but I don't
>>>>> see
>>>>> these examples as "substantial". I haven't found guidelines yet that
>>>>> better
>>>>> clarify the definition of "substantial".
>>>>>
>>>>>
>>>>>
>>

Re: Contribute Examples/Exercises

Posted by "Adam J. Shook" <ad...@gmail.com>.
For what it's worth, my intention was to update the examples to fit the ASF
and Accumulo standards and add them as examples of advanced
usage/patterns.  I don't expect all 11 to be contributed, as over half of
them are fairly simple examples showing off the basic Accumulo usage --
examples that are already in the core.  This thread was just a means to see
if it was worth the effort to massage a selection of the examples into the
ASF standards for the core examples library.

--Adam

On Wed, Nov 12, 2014 at 2:54 PM, Josh Elser <jo...@gmail.com> wrote:

> My worry with a contrib module is that, historically, code which goes
> moves to a contrib is just one step away from the grave. I think there's
> precedence for keeping them in core (as Christopher had mentioned, next to
> examples/simple) which would benefit people externally (more "how do I do
> X" examples) and internally (keep devs honest about how our APIs are
> implemented).
>
> Bringing the examples into the core also encourages us to grow the
> community which has been stagnant with respect to new committers for about
> 9 months now.
>
>
> Corey Nolet wrote:
>
>> +1 for adding the examples to contrib.
>>
>> I was, myself, reading over this email wondering how a set of 11 separate
>> examples on the use of Accumulo would fit into the core codebase-
>> especially as more are contributed over tinme. I like the idea of giving
>> community members an outlet for contributing examples that they've built
>> so
>> that we can continue to foster that without having to fit them in the core
>> codebase. It just seems more maintainable.
>>
>>
>> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>  wrote:
>>
>>  I'll take that as you disagree with my consideration of "substantial".
>>> Thanks.
>>>
>>>
>>> Mike Drob wrote:
>>>
>>>  The proposed contribution is a collection of 11 examples. It's clearly
>>>> non-trivial, which is probably enough to be considered "substantial"
>>>>
>>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>>> wrote:
>>>>
>>>>
>>>>  Sean Busbey wrote:
>>>>>
>>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>>>>>
>>>>>> wrote:
>>>>>>
>>>>>>    Personally, I didn't really think that this contribution was in the
>>>>>>
>>>>>>  spirit
>>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>>
>>>>>>> Some extra examples which leverage what Accumulo already does seems
>>>>>>> more
>>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>>
>>>>>>>
>>>>>>>    It's content developed out side of the project list. That's all it
>>>>>>>
>>>>>>>  takes to
>>>>>> require the trip through the Incubator checks as far as the ASF
>>>>>> guidelines
>>>>>> are concerned.
>>>>>>
>>>>>>
>>>>>>
>>>>>>    From http://incubator.apache.org/ip-clearance/index.html
>>>>>>
>>>>> """
>>>>>   From time to time, an external codebase is brought into the ASF that
>>>>> is
>>>>> not a separate incubating project but still represents a substantial
>>>>> contribution that was not developed within the ASF's source control
>>>>> system
>>>>> and on our public mailing lists.
>>>>> """
>>>>>
>>>>> Not to look a gift-horse in the mouth (it is great work), but I don't
>>>>> see
>>>>> these examples as "substantial". I haven't found guidelines yet that
>>>>> better
>>>>> clarify the definition of "substantial".
>>>>>
>>>>>
>>>>>
>>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
My worry with a contrib module is that, historically, code which goes 
moves to a contrib is just one step away from the grave. I think there's 
precedence for keeping them in core (as Christopher had mentioned, next 
to examples/simple) which would benefit people externally (more "how do 
I do X" examples) and internally (keep devs honest about how our APIs 
are implemented).

Bringing the examples into the core also encourages us to grow the 
community which has been stagnant with respect to new committers for 
about 9 months now.

Corey Nolet wrote:
> +1 for adding the examples to contrib.
>
> I was, myself, reading over this email wondering how a set of 11 separate
> examples on the use of Accumulo would fit into the core codebase-
> especially as more are contributed over tinme. I like the idea of giving
> community members an outlet for contributing examples that they've built so
> that we can continue to foster that without having to fit them in the core
> codebase. It just seems more maintainable.
>
>
> On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser<jo...@gmail.com>  wrote:
>
>> I'll take that as you disagree with my consideration of "substantial".
>> Thanks.
>>
>>
>> Mike Drob wrote:
>>
>>> The proposed contribution is a collection of 11 examples. It's clearly
>>> non-trivial, which is probably enough to be considered "substantial"
>>>
>>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>>> wrote:
>>>
>>>
>>>> Sean Busbey wrote:
>>>>
>>>>   On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>>>>> wrote:
>>>>>
>>>>>    Personally, I didn't really think that this contribution was in the
>>>>>
>>>>>> spirit
>>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>>
>>>>>> Some extra examples which leverage what Accumulo already does seems
>>>>>> more
>>>>>> like improvements for new Accumulo users than anything else.
>>>>>>
>>>>>>
>>>>>>    It's content developed out side of the project list. That's all it
>>>>>>
>>>>> takes to
>>>>> require the trip through the Incubator checks as far as the ASF
>>>>> guidelines
>>>>> are concerned.
>>>>>
>>>>>
>>>>>
>>>>>    From http://incubator.apache.org/ip-clearance/index.html
>>>> """
>>>>   From time to time, an external codebase is brought into the ASF that is
>>>> not a separate incubating project but still represents a substantial
>>>> contribution that was not developed within the ASF's source control
>>>> system
>>>> and on our public mailing lists.
>>>> """
>>>>
>>>> Not to look a gift-horse in the mouth (it is great work), but I don't see
>>>> these examples as "substantial". I haven't found guidelines yet that
>>>> better
>>>> clarify the definition of "substantial".
>>>>
>>>>
>

Re: Contribute Examples/Exercises

Posted by Corey Nolet <cj...@gmail.com>.
+1 for adding the examples to contrib.

I was, myself, reading over this email wondering how a set of 11 separate
examples on the use of Accumulo would fit into the core codebase-
especially as more are contributed over tinme. I like the idea of giving
community members an outlet for contributing examples that they've built so
that we can continue to foster that without having to fit them in the core
codebase. It just seems more maintainable.


On Wed, Nov 12, 2014 at 2:19 PM, Josh Elser <jo...@gmail.com> wrote:

> I'll take that as you disagree with my consideration of "substantial".
> Thanks.
>
>
> Mike Drob wrote:
>
>> The proposed contribution is a collection of 11 examples. It's clearly
>> non-trivial, which is probably enough to be considered "substantial"
>>
>> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>
>> wrote:
>>
>>
>>> Sean Busbey wrote:
>>>
>>>  On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>>>> wrote:
>>>>
>>>>   Personally, I didn't really think that this contribution was in the
>>>>
>>>>> spirit
>>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>>
>>>>> Some extra examples which leverage what Accumulo already does seems
>>>>> more
>>>>> like improvements for new Accumulo users than anything else.
>>>>>
>>>>>
>>>>>   It's content developed out side of the project list. That's all it
>>>>>
>>>> takes to
>>>> require the trip through the Incubator checks as far as the ASF
>>>> guidelines
>>>> are concerned.
>>>>
>>>>
>>>>
>>>>   From http://incubator.apache.org/ip-clearance/index.html
>>>
>>> """
>>>  From time to time, an external codebase is brought into the ASF that is
>>> not a separate incubating project but still represents a substantial
>>> contribution that was not developed within the ASF's source control
>>> system
>>> and on our public mailing lists.
>>> """
>>>
>>> Not to look a gift-horse in the mouth (it is great work), but I don't see
>>> these examples as "substantial". I haven't found guidelines yet that
>>> better
>>> clarify the definition of "substantial".
>>>
>>>
>>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
I'll take that as you disagree with my consideration of "substantial". 
Thanks.

Mike Drob wrote:
> The proposed contribution is a collection of 11 examples. It's clearly
> non-trivial, which is probably enough to be considered "substantial"
>
> On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser<jo...@gmail.com>  wrote:
>
>>
>> Sean Busbey wrote:
>>
>>> On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>>> wrote:
>>>
>>>   Personally, I didn't really think that this contribution was in the
>>>> spirit
>>>> of what the new codebase adoption guidelines were meant to cover.
>>>>
>>>> Some extra examples which leverage what Accumulo already does seems more
>>>> like improvements for new Accumulo users than anything else.
>>>>
>>>>
>>>>   It's content developed out side of the project list. That's all it
>>> takes to
>>> require the trip through the Incubator checks as far as the ASF guidelines
>>> are concerned.
>>>
>>>
>>>
>>  From http://incubator.apache.org/ip-clearance/index.html
>>
>> """
>>  From time to time, an external codebase is brought into the ASF that is
>> not a separate incubating project but still represents a substantial
>> contribution that was not developed within the ASF's source control system
>> and on our public mailing lists.
>> """
>>
>> Not to look a gift-horse in the mouth (it is great work), but I don't see
>> these examples as "substantial". I haven't found guidelines yet that better
>> clarify the definition of "substantial".
>>
>

Re: Contribute Examples/Exercises

Posted by Mike Drob <ma...@cloudera.com>.
The proposed contribution is a collection of 11 examples. It's clearly
non-trivial, which is probably enough to be considered "substantial"

On Wed, Nov 12, 2014 at 12:58 PM, Josh Elser <jo...@gmail.com> wrote:

>
>
> Sean Busbey wrote:
>
>> On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>
>> wrote:
>>
>>  Personally, I didn't really think that this contribution was in the
>>> spirit
>>> of what the new codebase adoption guidelines were meant to cover.
>>>
>>> Some extra examples which leverage what Accumulo already does seems more
>>> like improvements for new Accumulo users than anything else.
>>>
>>>
>>>  It's content developed out side of the project list. That's all it
>> takes to
>> require the trip through the Incubator checks as far as the ASF guidelines
>> are concerned.
>>
>>
>>
> From http://incubator.apache.org/ip-clearance/index.html
>
> """
> From time to time, an external codebase is brought into the ASF that is
> not a separate incubating project but still represents a substantial
> contribution that was not developed within the ASF's source control system
> and on our public mailing lists.
> """
>
> Not to look a gift-horse in the mouth (it is great work), but I don't see
> these examples as "substantial". I haven't found guidelines yet that better
> clarify the definition of "substantial".
>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.

Sean Busbey wrote:
> On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser<jo...@gmail.com>  wrote:
>
>> Personally, I didn't really think that this contribution was in the spirit
>> of what the new codebase adoption guidelines were meant to cover.
>>
>> Some extra examples which leverage what Accumulo already does seems more
>> like improvements for new Accumulo users than anything else.
>>
>>
> It's content developed out side of the project list. That's all it takes to
> require the trip through the Incubator checks as far as the ASF guidelines
> are concerned.
>
>

 From http://incubator.apache.org/ip-clearance/index.html

"""
 From time to time, an external codebase is brought into the ASF that is 
not a separate incubating project but still represents a substantial 
contribution that was not developed within the ASF's source control 
system and on our public mailing lists.
"""

Not to look a gift-horse in the mouth (it is great work), but I don't 
see these examples as "substantial". I haven't found guidelines yet that 
better clarify the definition of "substantial".

Re: Contribute Examples/Exercises

Posted by Sean Busbey <bu...@cloudera.com>.
On Wed, Nov 12, 2014 at 12:31 PM, Josh Elser <jo...@gmail.com> wrote:

> Personally, I didn't really think that this contribution was in the spirit
> of what the new codebase adoption guidelines were meant to cover.
>
> Some extra examples which leverage what Accumulo already does seems more
> like improvements for new Accumulo users than anything else.
>
>
It's content developed out side of the project list. That's all it takes to
require the trip through the Incubator checks as far as the ASF guidelines
are concerned.


-- 
Sean

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
Personally, I didn't really think that this contribution was in the 
spirit of what the new codebase adoption guidelines were meant to cover.

Some extra examples which leverage what Accumulo already does seems more 
like improvements for new Accumulo users than anything else.

Donald Miner wrote:
> Sean,
>
> My original thought here was that we could adapt these to fit the mold of
> the Accumulo examples that are shipped with core. Does that make any sense?
>
> Either way, the contrib approach seems reasonable as well, just not what I
> first thought.
>
> -d
>
> On Tue, Nov 11, 2014 at 12:18 PM, Sean Busbey<bu...@cloudera.com>  wrote:
>
>> I think these would be an excellent addition, given the improvements David
>> suggested. Since they span a range of Accumulo uses, they are probably best
>> served as a contrib repository[1] rather than an Accumulo version-specific
>> example.
>>
>> In any case this will involve adopting a non-trivial code base developed
>> outside of the project; we'll need to go through the ASF Incubator[2].
>> Before that can happen we'll need to call a vote[3].
>>
>> [1]: http://accumulo.apache.org/contrib.html
>> [2]: http://incubator.apache.org/faq.html#proposed_new_codebase
>>        http://incubator.apache.org/ip-clearance/index.html
>> [3]: http://accumulo.apache.org/bylaws.html#actions
>>
>> On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser<jo...@gmail.com>  wrote:
>>
>>> I've given a quick glance over them -- they look like they'd be a great
>>> addition!
>>>
>>> We'd have to figure out some mechanism to distribute the exercises (as we
>>> can't compile them), but that's a manageable problem.
>>>
>>> If you want to open an issue on JIRA, that'd be the first step to get
>>> these into the codebase. Some things to think about meanwhile:
>>>
>>> * Check out the coding practices and code formatting guidelines -
>>> http://accumulo.apache.org/source.html#coding-practices
>>> * Add ASL headers to the files
>>> * Figure out where might be a good place to include these in the Accumulo
>>> tree  - maybe examples/training?
>>> * Consider what documentation would be needed for someone to self-guide
>>> themselves through these examples
>>> * Look into redistribution rights on the included twitter.json file. I'm
>>> not sure what Twitter's terms of service are. It may be easier to write a
>>> script that will generate some example tweets. It keeps us from being
>>> liable for what those tweets contain and also prevents us from having to
>>> distribute a big blob.
>>>
>>> Thanks again!
>>>
>>>
>>> David Medinets wrote:
>>>
>>>> Can you add descriptions of the exercises to the README file? Many
>>>> people finding that page would move to the next one with details to
>>>> catch their interest.
>>>>
>>>> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<ch...@gmail.com>
>>>> wrote:
>>>>
>>>>> I believe they would be of benefit.
>>>>>
>>>>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<ad...@gmail.com>
>>>>> wrote:
>>>>>
>>>>>   I had just finished finalizing the training materials for a basic and
>>>>>> advanced Accumulo class my company ClearEdge IT offers.  I think some
>> of
>>>>>> the more advanced code tutorials would be valuable to contribute to
>> the
>>>>>> Accumulo examples library.
>>>>>>
>>>>>> The examples all work with status updates from Twitter and include
>>>>>> topics
>>>>>> such as:
>>>>>>
>>>>>>      - Basic Reading/Writing
>>>>>>      - Indexing tweets and creating a program to retrieve tweets based
>> on
>>>>>>      given search terms
>>>>>>      - Bulk ingestion of the tweets
>>>>>>      - Using MapReduce to building a geo-index table for the tweets
>> with
>>>>>>      latitude/longitude information via z-points
>>>>>>      - Levering the geo-index to retrieve tweets from a given lat/long
>>>>>>      bounding box
>>>>>>      - Custom iterators such as filters and combiners
>>>>>>
>>>>>> If this is something the community would be interested in, please take
>>>>>> the
>>>>>> time to review them at
>> https://github.com/adamjshook/accumulo-training
>>>>>> and
>>>>>> let me know if there are any you think would be worth contributing.
>>>>>> I'd be
>>>>>> happy to take the time to massage them to meet the standards.
>>>>>>
>>>>>> Cheers,
>>>>>> --Adam
>>>>>>
>>>>>>
>>
>> --
>> Sean
>>
>

Re: Contribute Examples/Exercises

Posted by Sean Busbey <bu...@cloudera.com>.
A big advantage of keeping them as a contrib is that it helps provide a
check on us maintaining expectations for downstream users.

We can choose as a community to keep them maintained; we'd primarily just
need to add a jenkins build that let us know when we broke them.

On Wed, Nov 12, 2014 at 11:59 AM, Christopher <ct...@apache.org> wrote:

> Adapting to the existing examples makes a bit more sense to me. If they're
> a contrib, I think they'd be better served as an externally maintained
> contrib. If we accept them into the project as an internal contrib, that
> kind of reflects a willingness and an obligation to maintain them, and
> that's less likely as an internal contrib than as part of the build
> examples or as an externally linked contrib, I think (from observing the
> state of the existing internal contrib repos).
>
>
> --
> Christopher L Tubbs II
> http://gravatar.com/ctubbsii
>
> On Wed, Nov 12, 2014 at 11:18 AM, Donald Miner <dm...@clearedgeit.com>
> wrote:
>
> > Sean,
> >
> > My original thought here was that we could adapt these to fit the mold of
> > the Accumulo examples that are shipped with core. Does that make any
> sense?
> >
> > Either way, the contrib approach seems reasonable as well, just not what
> I
> > first thought.
> >
> > -d
> >
> > On Tue, Nov 11, 2014 at 12:18 PM, Sean Busbey <bu...@cloudera.com>
> wrote:
> >
> > > I think these would be an excellent addition, given the improvements
> > David
> > > suggested. Since they span a range of Accumulo uses, they are probably
> > best
> > > served as a contrib repository[1] rather than an Accumulo
> > version-specific
> > > example.
> > >
> > > In any case this will involve adopting a non-trivial code base
> developed
> > > outside of the project; we'll need to go through the ASF Incubator[2].
> > > Before that can happen we'll need to call a vote[3].
> > >
> > > [1]: http://accumulo.apache.org/contrib.html
> > > [2]: http://incubator.apache.org/faq.html#proposed_new_codebase
> > >       http://incubator.apache.org/ip-clearance/index.html
> > > [3]: http://accumulo.apache.org/bylaws.html#actions
> > >
> > > On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser <jo...@gmail.com>
> > wrote:
> > >
> > > > I've given a quick glance over them -- they look like they'd be a
> great
> > > > addition!
> > > >
> > > > We'd have to figure out some mechanism to distribute the exercises
> (as
> > we
> > > > can't compile them), but that's a manageable problem.
> > > >
> > > > If you want to open an issue on JIRA, that'd be the first step to get
> > > > these into the codebase. Some things to think about meanwhile:
> > > >
> > > > * Check out the coding practices and code formatting guidelines -
> > > > http://accumulo.apache.org/source.html#coding-practices
> > > > * Add ASL headers to the files
> > > > * Figure out where might be a good place to include these in the
> > Accumulo
> > > > tree  - maybe examples/training?
> > > > * Consider what documentation would be needed for someone to
> self-guide
> > > > themselves through these examples
> > > > * Look into redistribution rights on the included twitter.json file.
> > I'm
> > > > not sure what Twitter's terms of service are. It may be easier to
> > write a
> > > > script that will generate some example tweets. It keeps us from being
> > > > liable for what those tweets contain and also prevents us from having
> > to
> > > > distribute a big blob.
> > > >
> > > > Thanks again!
> > > >
> > > >
> > > > David Medinets wrote:
> > > >
> > > >> Can you add descriptions of the exercises to the README file? Many
> > > >> people finding that page would move to the next one with details to
> > > >> catch their interest.
> > > >>
> > > >> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<
> > chris.p.rigano@gmail.com>
> > > >> wrote:
> > > >>
> > > >>> I believe they would be of benefit.
> > > >>>
> > > >>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<
> adamjshook@gmail.com
> > >
> > > >>> wrote:
> > > >>>
> > > >>>  I had just finished finalizing the training materials for a basic
> > and
> > > >>>> advanced Accumulo class my company ClearEdge IT offers.  I think
> > some
> > > of
> > > >>>> the more advanced code tutorials would be valuable to contribute
> to
> > > the
> > > >>>> Accumulo examples library.
> > > >>>>
> > > >>>> The examples all work with status updates from Twitter and include
> > > >>>> topics
> > > >>>> such as:
> > > >>>>
> > > >>>>     - Basic Reading/Writing
> > > >>>>     - Indexing tweets and creating a program to retrieve tweets
> > based
> > > on
> > > >>>>     given search terms
> > > >>>>     - Bulk ingestion of the tweets
> > > >>>>     - Using MapReduce to building a geo-index table for the tweets
> > > with
> > > >>>>     latitude/longitude information via z-points
> > > >>>>     - Levering the geo-index to retrieve tweets from a given
> > lat/long
> > > >>>>     bounding box
> > > >>>>     - Custom iterators such as filters and combiners
> > > >>>>
> > > >>>> If this is something the community would be interested in, please
> > take
> > > >>>> the
> > > >>>> time to review them at
> > > https://github.com/adamjshook/accumulo-training
> > > >>>> and
> > > >>>> let me know if there are any you think would be worth
> contributing.
> > > >>>> I'd be
> > > >>>> happy to take the time to massage them to meet the standards.
> > > >>>>
> > > >>>> Cheers,
> > > >>>> --Adam
> > > >>>>
> > > >>>>
> > >
> > >
> > > --
> > > Sean
> > >
> >
>



-- 
Sean

Re: Contribute Examples/Exercises

Posted by Christopher <ct...@apache.org>.
Adapting to the existing examples makes a bit more sense to me. If they're
a contrib, I think they'd be better served as an externally maintained
contrib. If we accept them into the project as an internal contrib, that
kind of reflects a willingness and an obligation to maintain them, and
that's less likely as an internal contrib than as part of the build
examples or as an externally linked contrib, I think (from observing the
state of the existing internal contrib repos).


--
Christopher L Tubbs II
http://gravatar.com/ctubbsii

On Wed, Nov 12, 2014 at 11:18 AM, Donald Miner <dm...@clearedgeit.com>
wrote:

> Sean,
>
> My original thought here was that we could adapt these to fit the mold of
> the Accumulo examples that are shipped with core. Does that make any sense?
>
> Either way, the contrib approach seems reasonable as well, just not what I
> first thought.
>
> -d
>
> On Tue, Nov 11, 2014 at 12:18 PM, Sean Busbey <bu...@cloudera.com> wrote:
>
> > I think these would be an excellent addition, given the improvements
> David
> > suggested. Since they span a range of Accumulo uses, they are probably
> best
> > served as a contrib repository[1] rather than an Accumulo
> version-specific
> > example.
> >
> > In any case this will involve adopting a non-trivial code base developed
> > outside of the project; we'll need to go through the ASF Incubator[2].
> > Before that can happen we'll need to call a vote[3].
> >
> > [1]: http://accumulo.apache.org/contrib.html
> > [2]: http://incubator.apache.org/faq.html#proposed_new_codebase
> >       http://incubator.apache.org/ip-clearance/index.html
> > [3]: http://accumulo.apache.org/bylaws.html#actions
> >
> > On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser <jo...@gmail.com>
> wrote:
> >
> > > I've given a quick glance over them -- they look like they'd be a great
> > > addition!
> > >
> > > We'd have to figure out some mechanism to distribute the exercises (as
> we
> > > can't compile them), but that's a manageable problem.
> > >
> > > If you want to open an issue on JIRA, that'd be the first step to get
> > > these into the codebase. Some things to think about meanwhile:
> > >
> > > * Check out the coding practices and code formatting guidelines -
> > > http://accumulo.apache.org/source.html#coding-practices
> > > * Add ASL headers to the files
> > > * Figure out where might be a good place to include these in the
> Accumulo
> > > tree  - maybe examples/training?
> > > * Consider what documentation would be needed for someone to self-guide
> > > themselves through these examples
> > > * Look into redistribution rights on the included twitter.json file.
> I'm
> > > not sure what Twitter's terms of service are. It may be easier to
> write a
> > > script that will generate some example tweets. It keeps us from being
> > > liable for what those tweets contain and also prevents us from having
> to
> > > distribute a big blob.
> > >
> > > Thanks again!
> > >
> > >
> > > David Medinets wrote:
> > >
> > >> Can you add descriptions of the exercises to the README file? Many
> > >> people finding that page would move to the next one with details to
> > >> catch their interest.
> > >>
> > >> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<
> chris.p.rigano@gmail.com>
> > >> wrote:
> > >>
> > >>> I believe they would be of benefit.
> > >>>
> > >>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<adamjshook@gmail.com
> >
> > >>> wrote:
> > >>>
> > >>>  I had just finished finalizing the training materials for a basic
> and
> > >>>> advanced Accumulo class my company ClearEdge IT offers.  I think
> some
> > of
> > >>>> the more advanced code tutorials would be valuable to contribute to
> > the
> > >>>> Accumulo examples library.
> > >>>>
> > >>>> The examples all work with status updates from Twitter and include
> > >>>> topics
> > >>>> such as:
> > >>>>
> > >>>>     - Basic Reading/Writing
> > >>>>     - Indexing tweets and creating a program to retrieve tweets
> based
> > on
> > >>>>     given search terms
> > >>>>     - Bulk ingestion of the tweets
> > >>>>     - Using MapReduce to building a geo-index table for the tweets
> > with
> > >>>>     latitude/longitude information via z-points
> > >>>>     - Levering the geo-index to retrieve tweets from a given
> lat/long
> > >>>>     bounding box
> > >>>>     - Custom iterators such as filters and combiners
> > >>>>
> > >>>> If this is something the community would be interested in, please
> take
> > >>>> the
> > >>>> time to review them at
> > https://github.com/adamjshook/accumulo-training
> > >>>> and
> > >>>> let me know if there are any you think would be worth contributing.
> > >>>> I'd be
> > >>>> happy to take the time to massage them to meet the standards.
> > >>>>
> > >>>> Cheers,
> > >>>> --Adam
> > >>>>
> > >>>>
> >
> >
> > --
> > Sean
> >
>

Re: Contribute Examples/Exercises

Posted by Christopher <ct...@apache.org>.
+1


--
Christopher L Tubbs II
http://gravatar.com/ctubbsii

On Wed, Nov 12, 2014 at 12:57 PM, David Medinets <da...@gmail.com>
wrote:

> I'll sound a note of caution. I love examples, but would not want to
> adversely affect the build times of Accumulo. Perhaps a link to the
> examples GitHub page at http://accumulo.apache.org/papers.html would
> suffice?
>

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
My first glance at the code didn't raise any concerns about 
significantly impacting the build time.

David Medinets wrote:
> I'll sound a note of caution. I love examples, but would not want to
> adversely affect the build times of Accumulo. Perhaps a link to the
> examples GitHub page at http://accumulo.apache.org/papers.html would
> suffice?

Re: Contribute Examples/Exercises

Posted by David Medinets <da...@gmail.com>.
I'll sound a note of caution. I love examples, but would not want to
adversely affect the build times of Accumulo. Perhaps a link to the
examples GitHub page at http://accumulo.apache.org/papers.html would
suffice?

Re: Contribute Examples/Exercises

Posted by Donald Miner <dm...@clearedgeit.com>.
Sean,

My original thought here was that we could adapt these to fit the mold of
the Accumulo examples that are shipped with core. Does that make any sense?

Either way, the contrib approach seems reasonable as well, just not what I
first thought.

-d

On Tue, Nov 11, 2014 at 12:18 PM, Sean Busbey <bu...@cloudera.com> wrote:

> I think these would be an excellent addition, given the improvements David
> suggested. Since they span a range of Accumulo uses, they are probably best
> served as a contrib repository[1] rather than an Accumulo version-specific
> example.
>
> In any case this will involve adopting a non-trivial code base developed
> outside of the project; we'll need to go through the ASF Incubator[2].
> Before that can happen we'll need to call a vote[3].
>
> [1]: http://accumulo.apache.org/contrib.html
> [2]: http://incubator.apache.org/faq.html#proposed_new_codebase
>       http://incubator.apache.org/ip-clearance/index.html
> [3]: http://accumulo.apache.org/bylaws.html#actions
>
> On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser <jo...@gmail.com> wrote:
>
> > I've given a quick glance over them -- they look like they'd be a great
> > addition!
> >
> > We'd have to figure out some mechanism to distribute the exercises (as we
> > can't compile them), but that's a manageable problem.
> >
> > If you want to open an issue on JIRA, that'd be the first step to get
> > these into the codebase. Some things to think about meanwhile:
> >
> > * Check out the coding practices and code formatting guidelines -
> > http://accumulo.apache.org/source.html#coding-practices
> > * Add ASL headers to the files
> > * Figure out where might be a good place to include these in the Accumulo
> > tree  - maybe examples/training?
> > * Consider what documentation would be needed for someone to self-guide
> > themselves through these examples
> > * Look into redistribution rights on the included twitter.json file. I'm
> > not sure what Twitter's terms of service are. It may be easier to write a
> > script that will generate some example tweets. It keeps us from being
> > liable for what those tweets contain and also prevents us from having to
> > distribute a big blob.
> >
> > Thanks again!
> >
> >
> > David Medinets wrote:
> >
> >> Can you add descriptions of the exercises to the README file? Many
> >> people finding that page would move to the next one with details to
> >> catch their interest.
> >>
> >> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<ch...@gmail.com>
> >> wrote:
> >>
> >>> I believe they would be of benefit.
> >>>
> >>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<ad...@gmail.com>
> >>> wrote:
> >>>
> >>>  I had just finished finalizing the training materials for a basic and
> >>>> advanced Accumulo class my company ClearEdge IT offers.  I think some
> of
> >>>> the more advanced code tutorials would be valuable to contribute to
> the
> >>>> Accumulo examples library.
> >>>>
> >>>> The examples all work with status updates from Twitter and include
> >>>> topics
> >>>> such as:
> >>>>
> >>>>     - Basic Reading/Writing
> >>>>     - Indexing tweets and creating a program to retrieve tweets based
> on
> >>>>     given search terms
> >>>>     - Bulk ingestion of the tweets
> >>>>     - Using MapReduce to building a geo-index table for the tweets
> with
> >>>>     latitude/longitude information via z-points
> >>>>     - Levering the geo-index to retrieve tweets from a given lat/long
> >>>>     bounding box
> >>>>     - Custom iterators such as filters and combiners
> >>>>
> >>>> If this is something the community would be interested in, please take
> >>>> the
> >>>> time to review them at
> https://github.com/adamjshook/accumulo-training
> >>>> and
> >>>> let me know if there are any you think would be worth contributing.
> >>>> I'd be
> >>>> happy to take the time to massage them to meet the standards.
> >>>>
> >>>> Cheers,
> >>>> --Adam
> >>>>
> >>>>
>
>
> --
> Sean
>

Re: Contribute Examples/Exercises

Posted by "Adam J. Shook" <ad...@gmail.com>.
Thank you all for the feedback!  I've opened ACCUMULO-3325
<https://issues.apache.org/jira/browse/ACCUMULO-3325> and I'll post the
discussion into the comments shortly.  I'll begin working on the
suggestions as well.

--Adam

On Tue Nov 11 2014 at 12:19:27 PM Sean Busbey <bu...@cloudera.com> wrote:

> I think these would be an excellent addition, given the improvements David
> suggested. Since they span a range of Accumulo uses, they are probably best
> served as a contrib repository[1] rather than an Accumulo version-specific
> example.
>
> In any case this will involve adopting a non-trivial code base developed
> outside of the project; we'll need to go through the ASF Incubator[2].
> Before that can happen we'll need to call a vote[3].
>
> [1]: http://accumulo.apache.org/contrib.html
> [2]: http://incubator.apache.org/faq.html#proposed_new_codebase
>       http://incubator.apache.org/ip-clearance/index.html
> [3]: http://accumulo.apache.org/bylaws.html#actions
>
> On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser <jo...@gmail.com> wrote:
>
> > I've given a quick glance over them -- they look like they'd be a great
> > addition!
> >
> > We'd have to figure out some mechanism to distribute the exercises (as we
> > can't compile them), but that's a manageable problem.
> >
> > If you want to open an issue on JIRA, that'd be the first step to get
> > these into the codebase. Some things to think about meanwhile:
> >
> > * Check out the coding practices and code formatting guidelines -
> > http://accumulo.apache.org/source.html#coding-practices
> > * Add ASL headers to the files
> > * Figure out where might be a good place to include these in the Accumulo
> > tree  - maybe examples/training?
> > * Consider what documentation would be needed for someone to self-guide
> > themselves through these examples
> > * Look into redistribution rights on the included twitter.json file. I'm
> > not sure what Twitter's terms of service are. It may be easier to write a
> > script that will generate some example tweets. It keeps us from being
> > liable for what those tweets contain and also prevents us from having to
> > distribute a big blob.
> >
> > Thanks again!
> >
> >
> > David Medinets wrote:
> >
> >> Can you add descriptions of the exercises to the README file? Many
> >> people finding that page would move to the next one with details to
> >> catch their interest.
> >>
> >> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<ch...@gmail.com>
> >> wrote:
> >>
> >>> I believe they would be of benefit.
> >>>
> >>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<ad...@gmail.com>
> >>> wrote:
> >>>
> >>>  I had just finished finalizing the training materials for a basic and
> >>>> advanced Accumulo class my company ClearEdge IT offers.  I think some
> of
> >>>> the more advanced code tutorials would be valuable to contribute to
> the
> >>>> Accumulo examples library.
> >>>>
> >>>> The examples all work with status updates from Twitter and include
> >>>> topics
> >>>> such as:
> >>>>
> >>>>     - Basic Reading/Writing
> >>>>     - Indexing tweets and creating a program to retrieve tweets based
> on
> >>>>     given search terms
> >>>>     - Bulk ingestion of the tweets
> >>>>     - Using MapReduce to building a geo-index table for the tweets
> with
> >>>>     latitude/longitude information via z-points
> >>>>     - Levering the geo-index to retrieve tweets from a given lat/long
> >>>>     bounding box
> >>>>     - Custom iterators such as filters and combiners
> >>>>
> >>>> If this is something the community would be interested in, please take
> >>>> the
> >>>> time to review them at https://github.com/adamjshook/
> accumulo-training
> >>>> and
> >>>> let me know if there are any you think would be worth contributing.
> >>>> I'd be
> >>>> happy to take the time to massage them to meet the standards.
> >>>>
> >>>> Cheers,
> >>>> --Adam
> >>>>
> >>>>
>
>
> --
> Sean
>

Re: Contribute Examples/Exercises

Posted by Sean Busbey <bu...@cloudera.com>.
I think these would be an excellent addition, given the improvements David
suggested. Since they span a range of Accumulo uses, they are probably best
served as a contrib repository[1] rather than an Accumulo version-specific
example.

In any case this will involve adopting a non-trivial code base developed
outside of the project; we'll need to go through the ASF Incubator[2].
Before that can happen we'll need to call a vote[3].

[1]: http://accumulo.apache.org/contrib.html
[2]: http://incubator.apache.org/faq.html#proposed_new_codebase
      http://incubator.apache.org/ip-clearance/index.html
[3]: http://accumulo.apache.org/bylaws.html#actions

On Tue, Nov 11, 2014 at 10:38 AM, Josh Elser <jo...@gmail.com> wrote:

> I've given a quick glance over them -- they look like they'd be a great
> addition!
>
> We'd have to figure out some mechanism to distribute the exercises (as we
> can't compile them), but that's a manageable problem.
>
> If you want to open an issue on JIRA, that'd be the first step to get
> these into the codebase. Some things to think about meanwhile:
>
> * Check out the coding practices and code formatting guidelines -
> http://accumulo.apache.org/source.html#coding-practices
> * Add ASL headers to the files
> * Figure out where might be a good place to include these in the Accumulo
> tree  - maybe examples/training?
> * Consider what documentation would be needed for someone to self-guide
> themselves through these examples
> * Look into redistribution rights on the included twitter.json file. I'm
> not sure what Twitter's terms of service are. It may be easier to write a
> script that will generate some example tweets. It keeps us from being
> liable for what those tweets contain and also prevents us from having to
> distribute a big blob.
>
> Thanks again!
>
>
> David Medinets wrote:
>
>> Can you add descriptions of the exercises to the README file? Many
>> people finding that page would move to the next one with details to
>> catch their interest.
>>
>> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<ch...@gmail.com>
>> wrote:
>>
>>> I believe they would be of benefit.
>>>
>>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<ad...@gmail.com>
>>> wrote:
>>>
>>>  I had just finished finalizing the training materials for a basic and
>>>> advanced Accumulo class my company ClearEdge IT offers.  I think some of
>>>> the more advanced code tutorials would be valuable to contribute to the
>>>> Accumulo examples library.
>>>>
>>>> The examples all work with status updates from Twitter and include
>>>> topics
>>>> such as:
>>>>
>>>>     - Basic Reading/Writing
>>>>     - Indexing tweets and creating a program to retrieve tweets based on
>>>>     given search terms
>>>>     - Bulk ingestion of the tweets
>>>>     - Using MapReduce to building a geo-index table for the tweets with
>>>>     latitude/longitude information via z-points
>>>>     - Levering the geo-index to retrieve tweets from a given lat/long
>>>>     bounding box
>>>>     - Custom iterators such as filters and combiners
>>>>
>>>> If this is something the community would be interested in, please take
>>>> the
>>>> time to review them at https://github.com/adamjshook/accumulo-training
>>>> and
>>>> let me know if there are any you think would be worth contributing.
>>>> I'd be
>>>> happy to take the time to massage them to meet the standards.
>>>>
>>>> Cheers,
>>>> --Adam
>>>>
>>>>


-- 
Sean

Re: Contribute Examples/Exercises

Posted by Josh Elser <jo...@gmail.com>.
I've given a quick glance over them -- they look like they'd be a great 
addition!

We'd have to figure out some mechanism to distribute the exercises (as 
we can't compile them), but that's a manageable problem.

If you want to open an issue on JIRA, that'd be the first step to get 
these into the codebase. Some things to think about meanwhile:

* Check out the coding practices and code formatting guidelines - 
http://accumulo.apache.org/source.html#coding-practices
* Add ASL headers to the files
* Figure out where might be a good place to include these in the 
Accumulo tree  - maybe examples/training?
* Consider what documentation would be needed for someone to self-guide 
themselves through these examples
* Look into redistribution rights on the included twitter.json file. I'm 
not sure what Twitter's terms of service are. It may be easier to write 
a script that will generate some example tweets. It keeps us from being 
liable for what those tweets contain and also prevents us from having to 
distribute a big blob.

Thanks again!

David Medinets wrote:
> Can you add descriptions of the exercises to the README file? Many
> people finding that page would move to the next one with details to
> catch their interest.
>
> On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano<ch...@gmail.com>  wrote:
>> I believe they would be of benefit.
>>
>> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook<ad...@gmail.com>
>> wrote:
>>
>>> I had just finished finalizing the training materials for a basic and
>>> advanced Accumulo class my company ClearEdge IT offers.  I think some of
>>> the more advanced code tutorials would be valuable to contribute to the
>>> Accumulo examples library.
>>>
>>> The examples all work with status updates from Twitter and include topics
>>> such as:
>>>
>>>     - Basic Reading/Writing
>>>     - Indexing tweets and creating a program to retrieve tweets based on
>>>     given search terms
>>>     - Bulk ingestion of the tweets
>>>     - Using MapReduce to building a geo-index table for the tweets with
>>>     latitude/longitude information via z-points
>>>     - Levering the geo-index to retrieve tweets from a given lat/long
>>>     bounding box
>>>     - Custom iterators such as filters and combiners
>>>
>>> If this is something the community would be interested in, please take the
>>> time to review them at https://github.com/adamjshook/accumulo-training and
>>> let me know if there are any you think would be worth contributing.  I'd be
>>> happy to take the time to massage them to meet the standards.
>>>
>>> Cheers,
>>> --Adam
>>>

Re: Contribute Examples/Exercises

Posted by David Medinets <da...@gmail.com>.
Can you add descriptions of the exercises to the README file? Many
people finding that page would move to the next one with details to
catch their interest.

On Tue, Nov 11, 2014 at 9:49 AM, Chris Rigano <ch...@gmail.com> wrote:
> I believe they would be of benefit.
>
> On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook <ad...@gmail.com>
> wrote:
>
>> I had just finished finalizing the training materials for a basic and
>> advanced Accumulo class my company ClearEdge IT offers.  I think some of
>> the more advanced code tutorials would be valuable to contribute to the
>> Accumulo examples library.
>>
>> The examples all work with status updates from Twitter and include topics
>> such as:
>>
>>    - Basic Reading/Writing
>>    - Indexing tweets and creating a program to retrieve tweets based on
>>    given search terms
>>    - Bulk ingestion of the tweets
>>    - Using MapReduce to building a geo-index table for the tweets with
>>    latitude/longitude information via z-points
>>    - Levering the geo-index to retrieve tweets from a given lat/long
>>    bounding box
>>    - Custom iterators such as filters and combiners
>>
>> If this is something the community would be interested in, please take the
>> time to review them at https://github.com/adamjshook/accumulo-training and
>> let me know if there are any you think would be worth contributing.  I'd be
>> happy to take the time to massage them to meet the standards.
>>
>> Cheers,
>> --Adam
>>

Re: Contribute Examples/Exercises

Posted by Chris Rigano <ch...@gmail.com>.
I believe they would be of benefit.

On Mon, Nov 10, 2014 at 12:43 PM, Adam J. Shook <ad...@gmail.com>
wrote:

> I had just finished finalizing the training materials for a basic and
> advanced Accumulo class my company ClearEdge IT offers.  I think some of
> the more advanced code tutorials would be valuable to contribute to the
> Accumulo examples library.
>
> The examples all work with status updates from Twitter and include topics
> such as:
>
>    - Basic Reading/Writing
>    - Indexing tweets and creating a program to retrieve tweets based on
>    given search terms
>    - Bulk ingestion of the tweets
>    - Using MapReduce to building a geo-index table for the tweets with
>    latitude/longitude information via z-points
>    - Levering the geo-index to retrieve tweets from a given lat/long
>    bounding box
>    - Custom iterators such as filters and combiners
>
> If this is something the community would be interested in, please take the
> time to review them at https://github.com/adamjshook/accumulo-training and
> let me know if there are any you think would be worth contributing.  I'd be
> happy to take the time to massage them to meet the standards.
>
> Cheers,
> --Adam
>