You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tinkerpop.apache.org by Stephen Mallette <sp...@gmail.com> on 2015/10/25 14:58:30 UTC
[DISCUSS] new "books" for 3.1.0-incubating
Now that we have our "book" model for documentation we can add different
classes of docs. For example, right now, we have our "Reference Book" and
our "Upgrading Book". I think that for 3.1.0-incubating it would be very
cool to get a "Developer Book" and, perhaps more importantly, a "Tutorial
Book".
The "developer" book would contain our dev docs for contributors. I would
basically roll the RELEASE and CONTRIBUTING content into it to start, but I
can think of other odds and ends we might add there over time.
The "tutorial" book would contain helpful user guides on specific topics.
Initially, it would probably be best to focus on "getting started" type
guides. Some suggestions:
1. TinkerPop in 5, 10 and 20 minutes
2. Data loading
3. Connecting to Gremlin Server (with different drivers)
Other ideas?
It would be nice to get 1 or 2 tutorials written in 3.1.0 so that we had a
good model available for future releases. Any volunteers who would like to
collaborate on a tutorial?
Re: [DISCUSS] new "books" for 3.1.0-incubating
Posted by Stephen Mallette <sp...@gmail.com>.
I created a couple of tickets to get the basic structure in place for the
developer book and the tutorial book:
https://issues.apache.org/jira/browse/TINKERPOP3-922
https://issues.apache.org/jira/browse/TINKERPOP3-923
Once I get those in place we can create tickets for the other tutorials
that folks suggested.
On Mon, Oct 26, 2015 at 4:07 PM, Stephen Mallette <sp...@gmail.com>
wrote:
> Nice Dylan - I would love if all of the driver providers could contribute
> to to that tutorial. 11/9 is code freeze, but as of right now we're
> leaving "small" documentation commits open during that period. I think
> that having one or two tutorials as part of 3.1.0 is that important that we
> should do what we have to in order to get them in there.
>
> On Mon, Oct 26, 2015 at 3:47 PM, Dylan Millikin <dy...@gmail.com>
> wrote:
>
>> Ah I somehow skipped some of the info here. Once there's a model article
>> up
>> I could definitely contribute a php driver tutorial. The repo freeze for
>> 3.1.0 is nov 9th right?
>>
>>
>> On Sun, Oct 25, 2015 at 3:35 PM, Marko Rodriguez <ok...@gmail.com>
>> wrote:
>>
>> > Cool. Thanks for the effort on this Stephen. Here are things I would
>> like
>> > to see:
>> >
>> > 1. Implementing the Structure and GraphComputer APIs. Help
>> > providers know how to get started.
>> > - e.g. MyGraph implements Graph.
>> > 2. Building a compiler from language X to the Gremlin traversal
>> > machine.
>> > - This smells of Kuppitz and SPARQL-Gremlin.. however
>> > perhaps another language -- regular expressions!? :D
>> > 3. What is the different between OLTP and OLAP? When, why,
>> where…
>> >
>> > I would like it if all the "books" had the same consistent funny, silly
>> > TinkerPop-vibe … cartoon examples, Gremlin in little outfits, etc.
>> >
>> > ********* Whoa. I just had an idea for Data Loading. Gremlin in a
>> bathtub
>> > with bubbles and a rubber Rexster "ducky" floating.
>> > "Scrub 'a dub dub your data."
>> >
>> > Take care,
>> > Marko.
>> >
>> > http://markorodriguez.com
>> >
>> > On Oct 25, 2015, at 7:58 AM, Stephen Mallette <sp...@gmail.com>
>> > wrote:
>> >
>> > > Now that we have our "book" model for documentation we can add
>> different
>> > > classes of docs. For example, right now, we have our "Reference Book"
>> > and
>> > > our "Upgrading Book". I think that for 3.1.0-incubating it would be
>> very
>> > > cool to get a "Developer Book" and, perhaps more importantly, a
>> "Tutorial
>> > > Book".
>> > >
>> > > The "developer" book would contain our dev docs for contributors. I
>> > would
>> > > basically roll the RELEASE and CONTRIBUTING content into it to start,
>> > but I
>> > > can think of other odds and ends we might add there over time.
>> > >
>> > > The "tutorial" book would contain helpful user guides on specific
>> topics.
>> > > Initially, it would probably be best to focus on "getting started"
>> type
>> > > guides. Some suggestions:
>> > >
>> > > 1. TinkerPop in 5, 10 and 20 minutes
>> > > 2. Data loading
>> > > 3. Connecting to Gremlin Server (with different drivers)
>> > >
>> > > Other ideas?
>> > >
>> > > It would be nice to get 1 or 2 tutorials written in 3.1.0 so that we
>> had
>> > a
>> > > good model available for future releases. Any volunteers who would
>> like
>> > to
>> > > collaborate on a tutorial?
>> >
>> >
>>
>
>
Re: [DISCUSS] new "books" for 3.1.0-incubating
Posted by Stephen Mallette <sp...@gmail.com>.
Nice Dylan - I would love if all of the driver providers could contribute
to to that tutorial. 11/9 is code freeze, but as of right now we're
leaving "small" documentation commits open during that period. I think
that having one or two tutorials as part of 3.1.0 is that important that we
should do what we have to in order to get them in there.
On Mon, Oct 26, 2015 at 3:47 PM, Dylan Millikin <dy...@gmail.com>
wrote:
> Ah I somehow skipped some of the info here. Once there's a model article up
> I could definitely contribute a php driver tutorial. The repo freeze for
> 3.1.0 is nov 9th right?
>
>
> On Sun, Oct 25, 2015 at 3:35 PM, Marko Rodriguez <ok...@gmail.com>
> wrote:
>
> > Cool. Thanks for the effort on this Stephen. Here are things I would like
> > to see:
> >
> > 1. Implementing the Structure and GraphComputer APIs. Help
> > providers know how to get started.
> > - e.g. MyGraph implements Graph.
> > 2. Building a compiler from language X to the Gremlin traversal
> > machine.
> > - This smells of Kuppitz and SPARQL-Gremlin.. however
> > perhaps another language -- regular expressions!? :D
> > 3. What is the different between OLTP and OLAP? When, why, where…
> >
> > I would like it if all the "books" had the same consistent funny, silly
> > TinkerPop-vibe … cartoon examples, Gremlin in little outfits, etc.
> >
> > ********* Whoa. I just had an idea for Data Loading. Gremlin in a bathtub
> > with bubbles and a rubber Rexster "ducky" floating.
> > "Scrub 'a dub dub your data."
> >
> > Take care,
> > Marko.
> >
> > http://markorodriguez.com
> >
> > On Oct 25, 2015, at 7:58 AM, Stephen Mallette <sp...@gmail.com>
> > wrote:
> >
> > > Now that we have our "book" model for documentation we can add
> different
> > > classes of docs. For example, right now, we have our "Reference Book"
> > and
> > > our "Upgrading Book". I think that for 3.1.0-incubating it would be
> very
> > > cool to get a "Developer Book" and, perhaps more importantly, a
> "Tutorial
> > > Book".
> > >
> > > The "developer" book would contain our dev docs for contributors. I
> > would
> > > basically roll the RELEASE and CONTRIBUTING content into it to start,
> > but I
> > > can think of other odds and ends we might add there over time.
> > >
> > > The "tutorial" book would contain helpful user guides on specific
> topics.
> > > Initially, it would probably be best to focus on "getting started" type
> > > guides. Some suggestions:
> > >
> > > 1. TinkerPop in 5, 10 and 20 minutes
> > > 2. Data loading
> > > 3. Connecting to Gremlin Server (with different drivers)
> > >
> > > Other ideas?
> > >
> > > It would be nice to get 1 or 2 tutorials written in 3.1.0 so that we
> had
> > a
> > > good model available for future releases. Any volunteers who would
> like
> > to
> > > collaborate on a tutorial?
> >
> >
>
Re: [DISCUSS] new "books" for 3.1.0-incubating
Posted by Dylan Millikin <dy...@gmail.com>.
Ah I somehow skipped some of the info here. Once there's a model article up
I could definitely contribute a php driver tutorial. The repo freeze for
3.1.0 is nov 9th right?
On Sun, Oct 25, 2015 at 3:35 PM, Marko Rodriguez <ok...@gmail.com>
wrote:
> Cool. Thanks for the effort on this Stephen. Here are things I would like
> to see:
>
> 1. Implementing the Structure and GraphComputer APIs. Help
> providers know how to get started.
> - e.g. MyGraph implements Graph.
> 2. Building a compiler from language X to the Gremlin traversal
> machine.
> - This smells of Kuppitz and SPARQL-Gremlin.. however
> perhaps another language -- regular expressions!? :D
> 3. What is the different between OLTP and OLAP? When, why, where…
>
> I would like it if all the "books" had the same consistent funny, silly
> TinkerPop-vibe … cartoon examples, Gremlin in little outfits, etc.
>
> ********* Whoa. I just had an idea for Data Loading. Gremlin in a bathtub
> with bubbles and a rubber Rexster "ducky" floating.
> "Scrub 'a dub dub your data."
>
> Take care,
> Marko.
>
> http://markorodriguez.com
>
> On Oct 25, 2015, at 7:58 AM, Stephen Mallette <sp...@gmail.com>
> wrote:
>
> > Now that we have our "book" model for documentation we can add different
> > classes of docs. For example, right now, we have our "Reference Book"
> and
> > our "Upgrading Book". I think that for 3.1.0-incubating it would be very
> > cool to get a "Developer Book" and, perhaps more importantly, a "Tutorial
> > Book".
> >
> > The "developer" book would contain our dev docs for contributors. I
> would
> > basically roll the RELEASE and CONTRIBUTING content into it to start,
> but I
> > can think of other odds and ends we might add there over time.
> >
> > The "tutorial" book would contain helpful user guides on specific topics.
> > Initially, it would probably be best to focus on "getting started" type
> > guides. Some suggestions:
> >
> > 1. TinkerPop in 5, 10 and 20 minutes
> > 2. Data loading
> > 3. Connecting to Gremlin Server (with different drivers)
> >
> > Other ideas?
> >
> > It would be nice to get 1 or 2 tutorials written in 3.1.0 so that we had
> a
> > good model available for future releases. Any volunteers who would like
> to
> > collaborate on a tutorial?
>
>
Re: [DISCUSS] new "books" for 3.1.0-incubating
Posted by Marko Rodriguez <ok...@gmail.com>.
Cool. Thanks for the effort on this Stephen. Here are things I would like to see:
1. Implementing the Structure and GraphComputer APIs. Help providers know how to get started.
- e.g. MyGraph implements Graph.
2. Building a compiler from language X to the Gremlin traversal machine.
- This smells of Kuppitz and SPARQL-Gremlin.. however perhaps another language -- regular expressions!? :D
3. What is the different between OLTP and OLAP? When, why, where…
I would like it if all the "books" had the same consistent funny, silly TinkerPop-vibe … cartoon examples, Gremlin in little outfits, etc.
********* Whoa. I just had an idea for Data Loading. Gremlin in a bathtub with bubbles and a rubber Rexster "ducky" floating.
"Scrub 'a dub dub your data."
Take care,
Marko.
http://markorodriguez.com
On Oct 25, 2015, at 7:58 AM, Stephen Mallette <sp...@gmail.com> wrote:
> Now that we have our "book" model for documentation we can add different
> classes of docs. For example, right now, we have our "Reference Book" and
> our "Upgrading Book". I think that for 3.1.0-incubating it would be very
> cool to get a "Developer Book" and, perhaps more importantly, a "Tutorial
> Book".
>
> The "developer" book would contain our dev docs for contributors. I would
> basically roll the RELEASE and CONTRIBUTING content into it to start, but I
> can think of other odds and ends we might add there over time.
>
> The "tutorial" book would contain helpful user guides on specific topics.
> Initially, it would probably be best to focus on "getting started" type
> guides. Some suggestions:
>
> 1. TinkerPop in 5, 10 and 20 minutes
> 2. Data loading
> 3. Connecting to Gremlin Server (with different drivers)
>
> Other ideas?
>
> It would be nice to get 1 or 2 tutorials written in 3.1.0 so that we had a
> good model available for future releases. Any volunteers who would like to
> collaborate on a tutorial?