[ 
https://issues.apache.org/jira/browse/TINKERPOP-1816?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16222302#comment-16222302
 ] 

Florian Hockmann commented on TINKERPOP-1816:
---------------------------------------------

My guess was that Bill simply assumed that the documentation for Gremlin.Net 
should include everything one needs to know to start using Gremlin in .NET. 
That's probably how the documentation for most projects work. Of course this 
can't work with our docs as most of it is language independent and the language 
specific sections only contain information that is really specific to that 
particular language.

In the long term it might be an option to generate different version of the 
docs for the different languages where all code examples are written in that 
specific language. Then a user interested in .NET could simply switch to the 
.NET documentation and get all steps explained with Gremlin.Net syntax.

{quote}
the .NET docs are generally just a clone of the Python docs if I'm not mistaken.
{quote}
Exactly, I simply copied the docs from Python and adapted them for .NET were 
necessary.

> Consider improvements to the .NET documentation
> -----------------------------------------------
>
>                 Key: TINKERPOP-1816
>                 URL: https://issues.apache.org/jira/browse/TINKERPOP-1816
>             Project: TinkerPop
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 3.2.6
>            Reporter: Bill Woo
>            Priority: Minor
>
> Without at least one complete code sample, you are wasting potential users; 
> time.
> How do you run a query/traversal ?  
> By "stumbling around in the dark" I was able to get this far:
>             private Graph graph = new Graph();
>             private GraphTraversalSource g;
>             // in method body
>             g = graph.Traversal().WithRemote(new DriverRemoteConnection(new 
> GremlinClient(new GremlinServer("localhost", 8182))));
>             
>             Vertex v1 = new Vertex("Bill");
>             g.AddV(v1);
>             Vertex v2 = new Vertex("Julie");
>             g.AddV(v2);
>             Edge e1 = new Edge("e1", v1, "Knows", v2);
>             g.AddE(e1);
>             VertexProperty p1 = new VertexProperty("p1","BillProp", 
> "TestProp", v1);



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

Reply via email to