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

stephen mallette commented on TINKERPOP-1816:
---------------------------------------------

> Without a certain minimal level of documentation, there is nothing to improve.

By that logic, no one should make any attempt to write any documentation at all 
- everything starts with nothing and in this case there is more that you are 
giving credit for. 

> If it one could infer the syntax of the .NET port from the other platform 
> examples 

why can't you? Isn't Gremlin just Gremlin? 

{code}
g.V().out("knows")  // java
g.V().out('knows')   // groovy
g.V().out('knows')   # python
g.V().Out('knows')  // c#
{code}

The only difference is the capitalization of steps in C# which is sort of 
expected as it stays in line with .NET naming patterns. 

> I suggest you remove the .NET port until it is minimally useful without 
> "stumbling around."

First of all, we still do not have an "official" distribution for .NET beyond a 
release candidate - it's just 3.3.0-rc1 and 3.2.6-rc1. The first sentence in 
the link i provided says:

> WARNING: Gremlin.Net does not yet have an official release. It is for 
> developers who want to experiment with TinkerPop in the .NET ecosystem.

Second, if the world was removed of every open source project that didn't have 
documentation written by a team of technical writers, most technology on this 
planet would immediately cease to function Open source projects rely on 
contributions from the community of users it services. If you are dissatisfied 
with what you are using then feel free to use something else or help us to 
improve what we do have. The TinkerPop community and the .NET community will 
thank you for it. 

> 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