spmallette commented on code in PR #3458: URL: https://github.com/apache/tinkerpop/pull/3458#discussion_r3423787645
########## docs/src/reference/the-traversal.asciidoc: ########## @@ -2112,6 +2119,24 @@ the key,value pairs for those vertices. <9> Property key is always stored as `String` and therefore an equality check with `null` will produce no result. <10> An example of using `has()` with regular expression predicate. +The traversal-accepting forms of `has()` allow for dynamic property comparisons. Rather than providing a literal value, +a child traversal is supplied and its first result is used as the comparison value. This follows the same first-result +semantics as `by(traversal)`. The child traversal must be read-only - mutating steps are rejected. Review Comment: > The child traversal must be read-only - mutating steps are rejected. Don't really like dashes in our docs this way, how about: "The child traversal cannot include mutating steps like `addV()` or `mergeE()`. If these steps are present, they will be rejected at runtime with a `XYZException`." -- 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]
