[
https://issues.apache.org/jira/browse/TINKERPOP-2002?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16685586#comment-16685586
]
ASF GitHub Bot commented on TINKERPOP-2002:
-------------------------------------------
spmallette opened a new pull request #996: TINKERPOP-2002 Documentation
restructuring
URL: https://github.com/apache/tinkerpop/pull/996
https://issues.apache.org/jira/browse/TINKERPOP-2002
I bound this PR to TINKERPOP-2002 as it touches on some of the points made
there, but this set of changes is far more reaching than what was described
there. Basically restructured the entire Introduction section as well as the
Gremlin Variants section to better engage new users coming from any programming
language and heading toward any type of TinkerPop-enabled graph.
I've published 3.4.0-SNAPSHOT documentation as it might be easier to consume
than looking at it here in this diff. There is perhaps some more work that
could be done between now and release, but I think it's at a good stopping
point now and is largely publishable as-is. There is a minor bug somewhere in
the tab generation for static code, so just ignore that for now - kuppitz is
looking at that.
http://tinkerpop.apache.org/docs/3.4.0-SNAPSHOT/reference
VOTE +1
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
> Create a blog post explaining the value of using TinkerPop
> ----------------------------------------------------------
>
> Key: TINKERPOP-2002
> URL: https://issues.apache.org/jira/browse/TINKERPOP-2002
> Project: TinkerPop
> Issue Type: Improvement
> Components: documentation
> Affects Versions: 3.2.9
> Reporter: Jeremy Hanna
> Priority: Major
>
> There are a lot of great references and recipes in the TinkerPop docs. One
> thing that would be nice to have is a simple explanation of what it means to
> use a TinkerPop implementation and what that guarantees. People coming from a
> relational world may misunderstand what to expect and might think they can do
> the equivalent of plugging in a new JDBC driver and away they go.
> Some things to include
> * How traversals are implementation agnostic with some caveats
> ** data types
> ** indexes
> * Connection options - different implementations may allow you to use
> TinkerPop drivers but may have implementation specific drivers for things
> like security or cluster awareness
> * How to migrate easily between TinkerPop implementations should the need
> arise
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
