spmallette opened a new pull request, #3615: URL: https://github.com/apache/tinkerpop/pull/3615
This is a small, conservative documentation fix touching two reference sections. ## Gremlin-Groovy differences (`reference/gremlin-variants.asciidoc`) The section previously stated that `as`, `in`, and `not` are reserved words that "must always be prefixed with `__.`". The recommendation to use the `__.` prefix is kept, but the justification is reframed: rather than a hard reserved-word parser rule, the reason to be explicit is to get deterministic, portable resolution — use `__.` for an anonymous traversal step, and `P.` when you actually want a predicate. This is clarified especially for `not`: a bare `not(...)` resolves to `P.not(P)` (predicate negation), whereas `__.not(traversal)` is the filter step. Being explicit (`__.not(...)` for the step, `P.not(...)` for the predicate) avoids the ambiguity. A note is also added that `datetime()` returns a `java.time.OffsetDateTime`, which the section did not previously state. ## Canonical Gremlin literal types (`reference/the-traversal.asciidoc`) The `DateTime` row now notes that the all-lowercase `datetime` form is also accepted (the grammar accepts `datetime`, `DateTime`, and `DATETIME`). ## Testing Built the rendered documentation locally (`bin/process-docs.sh`) and reviewed the affected pages in the HTML output; all three changes render as intended. -- 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]
