This is an automated email from the ASF dual-hosted git repository. spmallette pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit 9555793c3052037fd1539b3f8be323fbc09bc59c Author: Stephen Mallette <[email protected]> AuthorDate: Wed Jul 29 16:41:43 2026 +0000 Clarify path() filtering of non-productive properties in reference docs Reword the first path()-step callout so it is clear that filtering happens at the traverser level: when a path element lacks a productive value for the by()-projected property, the entire path is removed rather than just the missing value being omitted, which is why the example result count drops from 12 to 4. Also add the modern-graph load and traversal-source lines to the example so the snippet is self-contained. Assisted-by: Kiro:claude-opus-4.8 --- docs/src/reference/the-traversal.asciidoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc index e92247fa67..0c49c36b75 100644 --- a/docs/src/reference/the-traversal.asciidoc +++ b/docs/src/reference/the-traversal.asciidoc @@ -3488,7 +3488,9 @@ g.V().out().out().values('name').path() g.V().both().path().by('age') <1> ---- -<1> The "age" property is not <<by-step,productive>> for all vertices and therefore those values are filtered. +<1> The "age" property is not <<by-step,productive>> for all vertices; any path that contains an element without a +productive "age" value is filtered out in its entirety (the entire traverser is removed, not just the missing value), +which reduces the number of results from 12 to 4. If edges are required in the path, then be sure to traverse those edges explicitly.
