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 b215dda0ae3a4283e4dad996b5c56f08009dc6db Author: Stephen Mallette <[email protected]> AuthorDate: Mon Mar 30 11:24:51 2026 +0000 Minor doc fixes/improvements CTR --- docs/src/dev/developer/development-environment.asciidoc | 12 ++++++------ docs/src/dev/provider/gremlin-semantics.asciidoc | 8 ++++---- docs/src/reference/the-traversal.asciidoc | 4 ++-- docs/src/upgrade/release-3.7.x.asciidoc | 4 ++++ 4 files changed, 16 insertions(+), 12 deletions(-) diff --git a/docs/src/dev/developer/development-environment.asciidoc b/docs/src/dev/developer/development-environment.asciidoc index d995e863b8..5756bc8da8 100644 --- a/docs/src/dev/developer/development-environment.asciidoc +++ b/docs/src/dev/developer/development-environment.asciidoc @@ -19,8 +19,8 @@ under the License. [[development-environment]] = Development Environment -TinkerPop is fairly large body of code spread across many modules and covering multiple programming languages. Despite -this complexity, it remains relatively straightforward a project to build. This following subsections explain how to +TinkerPop is a fairly large body of code spread across many modules and covering multiple programming languages. Despite +this complexity, it remains a relatively straightforward project to build. The following subsections explain how to configure a development environment for TinkerPop. image:conspiracy.png[] @@ -417,10 +417,10 @@ username = <username> password = ---- -The approach above assumes basic authentication and a blank password will in `.pyirc` will have Maven prompt for a +The approach above assumes basic authentication and a blank password in `.pypirc` will have Maven prompt for a password. That said, it is preferred that your account be secured with 2FA, in which case, basic authentication will no longer be allowed. Instead, an API token is required. It can be generated under your -link:https://pypi.org/manage/account/token/[account settings] and then the username in `.pyirc` is set to `__token__` +link:https://pypi.org/manage/account/token/[account settings] and then the username in `.pypirc` is set to `__token__` and the password to the token value. Please see link:https://pypi.org/help/#apitoken[PyPI documentation] for more details. @@ -457,10 +457,10 @@ be done automatically on `mvn deploy` or it can be triggered manually with `mvn == Using AI Coding Agents TinkerPop does not endorse or require any particular AI Coding Agents or tool. As a result, tool-specific project -guidelines are not included with the code base. TinkerPop does however provide for a generic, agent-agnostic `AGENTS.MD` +guidelines are not included with the code base. TinkerPop does, however, provide for a generic, agent-agnostic `AGENTS.md` file at the root of the project. Developers should make use of this file's instructions by pointing their specific AI-based tool to it. While tools may vary in how they are set up, the approach is to treat tool-specific files, such as -`.junie/guidelines.md`, `.claude/CLAUDE.md` etc., as thin shims that just point to TinkerPop's `AGENTS.MD` instead of +`.junie/guidelines.md`, `.claude/CLAUDE.md` etc., as thin shims that just point to TinkerPop's `AGENTS.md` instead of relying on individual rules. The content of those tool-specific files should: * Explain that AGENTS.md is the canonical source. diff --git a/docs/src/dev/provider/gremlin-semantics.asciidoc b/docs/src/dev/provider/gremlin-semantics.asciidoc index 898956bee8..4f97df5552 100644 --- a/docs/src/dev/provider/gremlin-semantics.asciidoc +++ b/docs/src/dev/provider/gremlin-semantics.asciidoc @@ -1278,7 +1278,7 @@ with `mergeV` via a `select` operation. * `Map` arguments are validated for their keys resulting in exception if they do not meet requirements defined above. * Use of `T.label` should always have a value that is a `String`. -* If `T.id`, `T.label`, and/or `Direction.IN/OUT` are specified in `searchCreate`, they cannot be overriden in `onCreate`. +* If `T.id`, `T.label`, and/or `Direction.IN/OUT` are specified in `searchCreate`, they cannot be overridden in `onCreate`. * For late binding of the from and to vertices, `Direction.OUT` must be set to `Merge.outV` and `Direction.IN` must be set to `Merge.inV`. Other combinations are not allowed and will result in exception. @@ -1309,9 +1309,9 @@ link:https://tinkerpop.apache.org/docs/x.y.z/reference/#mergee-step[reference] * `onCreate` - A `Map` used to specify additional existence criteria and/or properties not already specified in `searchCreate`. * `onMatch` - A `Map` used to update the `Vertex` that is found using the `searchCreate` criteria. -The `searchCreate` and `onCreate` `Map` instances must consists of any combination of `T.id`, `T.label`, or arbitrary +The `searchCreate` and `onCreate` `Map` instances must consist of any combination of `T.id`, `T.label`, or arbitrary `String` keys (which are assumed to be vertex properties). The `onMatch` `Map` instance only allows for `String` keys -as the `id` and `label` of a `Vertex` are immutable. `null` Values for these valid keys are not allowed. +as the `id` and `label` of a `Vertex` are immutable. `null` values for these valid keys are not allowed. The `Map` that is used as the argument for `searchCreate` may be assigned from the incoming `Traverser` for the no-arg `mergeV()`. If `mergeV(Map)` is used, then it will override the incoming `Traverser`. If `mergeV(Traversal)` is used, @@ -1346,7 +1346,7 @@ resolve to a `Map`. * `Map` arguments are validated for their keys resulting in exception if they do not meet requirements defined above. * Use of `T.label` should always have a value that is a `String`. -* If `T.id` and/or `T.label` are specified in `searchCreate`, they cannot be overriden in `onCreate`. +* If `T.id` and/or `T.label` are specified in `searchCreate`, they cannot be overridden in `onCreate`. *Considerations:* diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc index 6b99d76f79..0715d31107 100644 --- a/docs/src/reference/the-traversal.asciidoc +++ b/docs/src/reference/the-traversal.asciidoc @@ -6063,8 +6063,8 @@ g.V().outE().inV(). by('name') ---- -WARNING: It is not advisable to provide filtering traversals that do more than just filter (e.g. mutation steps, -side-effects, etc.) - prefer use of the standard `has()` step variations for best results. +WARNING: It is not advisable to provide filtering traversals that do more than just filter (e.g. map-type steps, +mutation steps, side-effects, etc.) - prefer use of the standard `has()` step variations for best results. === VertexProgramDenyStrategy diff --git a/docs/src/upgrade/release-3.7.x.asciidoc b/docs/src/upgrade/release-3.7.x.asciidoc index b589a4035c..524179c87e 100644 --- a/docs/src/upgrade/release-3.7.x.asciidoc +++ b/docs/src/upgrade/release-3.7.x.asciidoc @@ -55,6 +55,10 @@ respectively. It is important that you review your code for these patterns as pa See: link:https://issues.apache.org/jira/browse/TINKERPOP-3235[TINKERPOP-3235] +==== Runtime Upgrades + +Gremlin Javascript now supports Node 22 and 24 alongside Node 20. + === Upgrading for Providers ==== Graph System Providers
