spmallette commented on code in PR #3211:
URL: https://github.com/apache/tinkerpop/pull/3211#discussion_r2440634022
##########
docs/src/reference/the-traversal.asciidoc:
##########
@@ -5553,6 +5551,36 @@ g.V().as('a').both().both().as('b').count()
g.V().as('a').both().both().as('b').where('a',neq('b')).count()
----
+[[a-note-on-types]]
+== A Note on Types
Review Comment:
I think this section jumps a bit too quickly to the details and needs more
introductory text to help orient readers to what they are about to read.
> Gremlin steps typically operate over a handful of types that are mostly
standard across graph systems. There are the common primitive types like, .....
container types, like, .... and structural types particular to graphs such as
Vertex, Edge, etc.......... Gremlin identifies these types in the `GType`
enumeration, offering a clear presentation of the standard data types one might
typically encounter with Gremlin. This enumeration is an important part of the
Gremlin language in that it acts as the argument to the `typeOf` predicate used
for filtering values based on their runtime data type.
>
> `GType` consists of the following enumerations:
I quickly hacked that together, but perhaps it conveys the difference in
tone and lead-in?
--
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]
