[
https://issues.apache.org/jira/browse/TINKERPOP-1915?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
stephen mallette closed TINKERPOP-1915.
---------------------------------------
Resolution: Invalid
we like to have a little fun. sorry you don't get it.
why ask for help this way though? is this just a frustration jira? couldn't you
just send a message to the [mailing
list|https://groups.google.com/forum/#!forum/gremlin-users] and ask, "Hi
everyone, I"m just getting started with Gremlin and I come from the RDF world
and feel a bit lost as the documentation doesn't really get into that topic
anywhere and I can't find other resources to help me. What's the easiest way to
import an NQuad to a graph so that I can work with it in Gremlin? By the way,
weird intro to the documentation - what's with all the 'machine elf' stuff?"
To which, I or someone would reply: "Thanks for checking out Gremlin and
TinkerPop. We don't have an NQuad import facility which is why you don't see
anything in the docs about such things. You would likely have to write some
form of Gremlin import script or rely on the tooling of your underlying graph
database that could directly import such things (if such facilities exist for
your graph). As for the documentation, we like to have a little fun basically.
What you are reading there is essentially the "lore" of the TinkerPop graph
multiiverse. We use Gremlin, his friends and that lore to help explain graphs,
querying and the various aspects of the TinkerPop stack. A nice example of this
is the "Tales From the TinkerPop" blog post found
[here|https://www.datastax.com/dev/blog/tales-from-the-tinkerpop]. Most people
I've talked to tend to find this approach to documentation and learning
entertaining and unique, but we understand that it's not for everyone.
Hopefully, it will not distract or dissuade you from looking further into what
truly is a powerful technology system for building graph applications."
the one thing i did extract from here that might be construed as productive was
"Where is the search functionality??" I think that the project would be open to
such things, but I personally don't know how we would put that in play. Right
now we pretty much generate all our HTML docs from asciidoc which is then
uploaded to Apache SVN infrastructure which in then in turn published to more
Apache webserver stuff (none of which we have direct control of afaik). Not
sure what would need to change in all that to produce a search capability. if
you are knowledgeable on such things it would be nice to hear how we might have
something like that. Feel free to propose anything like that on our [developer
mailing list|https://lists.apache.org/[email protected]].
anyway, hopefully i answered your questions. i'm just going to close this
because it really isn't something productive that we're going to track. take
care....
> Documentation is absolutely ridiculous
> --------------------------------------
>
> Key: TINKERPOP-1915
> URL: https://issues.apache.org/jira/browse/TINKERPOP-1915
> Project: TinkerPop
> Issue Type: Improvement
> Components: documentation
> Reporter: Adam P
> Priority: Major
>
> I'm sorry but the documentation is absolutely ridiculous. It feels like a
> children's book author got fired from his day job, did a bunch of drugs
> decided to write some documentation
> ([http://tinkerpop.apache.org/docs/current/reference/]) . I would normally
> endorse this multidisciplinary fun but it makes it harder to find things.
> Where is the search functionality??
> I just want to figure out how to import NQuad RDF into gremlin and instead
> i'm reading about how Gremlin one day came to a realization and something
> about a machine elf..??
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
