spmallette opened a new pull request, #3551:
URL: https://github.com/apache/tinkerpop/pull/3551

   The *Declarative TraversalSources* section of the Gremlin Server reference 
shows how to declare named traversal sources (for example `g` and `gReadOnly`) 
in the server YAML, but it does not explain how a client actually routes a 
query to one of those named sources. A newcomer who configures `gReadOnly` has 
no way to discover that a bare `gReadOnly.V()` will not work, because a 
`gremlin-lang` traversal must begin with `g`.
   
   This adds two short admonitions after the `traversalSources` declaration 
content:
   
   - A NOTE explaining that a client chooses which named `TraversalSource` to 
run against through the request-level `g` alias (the traversal-source argument 
supplied when creating a remote connection, cross-referenced to *Connecting via 
Drivers*), while the traversal itself is still written as `g.V()...`.
   - A TIP noting that a `graphs`-only server configuration is valid on its own 
because the remaining server settings fall back to sensible defaults.
   
   The change is additive prose only — the existing YAML declaration content is 
unchanged and no unrelated content was touched. The docs render cleanly.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to