[TINKERPOP-2354] Document recommendation to reuse graph traversal source

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Done
• Affects Version/s: 3.3.10
• Fix Version/s: 3.5.0, 3.3.11, 3.4.7
• Component/s: documentation
• Assignee: Stephen Mallette
• Reporter: Florian Hockmann
• Created: 25/Mar/20 15:42
• Updated: 23/Apr/20 17:42
• Resolved: 23/Apr/20 17:42

Description

We recommend that users reuse the graph traversal source across their application. One reason for that is that the same driver instance is used for all traversals which is necessary to use the connection pool efficiently.

This recommendation should also be in the docs to make users aware of it. spmallette mentioned these places to add this recommendation to:

1. https://tinkerpop.apache.org/docs/current/tutorials/gremlins-anatomy/ - in GraphTraversalSource section
2. https://tinkerpop.apache.org/docs/current/tutorials/getting-started/ - where we first show how to instantiate g
3. https://tinkerpop.apache.org/docs/current/reference/#connecting-gremlin

or written up well once in the reference docs and linked to from the other locations....