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
The following commit(s) were added to refs/heads/master by this push:
new 3726021e30 Add missing llms-summary tags for 3.8 content on 3.8-dev
new cbc007d2d1 Merge branch '3.8-dev'
3726021e30 is described below
commit 3726021e30277066df9202cd7e06e9af7d0cb385
Author: Stephen Mallette <[email protected]>
AuthorDate: Wed Jul 29 20:38:19 2026 +0000
Add missing llms-summary tags for 3.8 content on 3.8-dev
The Agent Friendly Docs merge left gaps in llms-summary coverage for
content that had drifted into the newer branch. Two classes were fixed:
- The new release-3.8.0/1/2 upgrade files carried no summaries, gluing
all 3.8 upgrade content onto upgrade/index.md (102KB, over the 50KB
page budget and failing the --strict split). Added summaries to each
point release, split 3.8.0's provider notes to their own page, and
marked 3.8.0's large users page allow-oversize (mirroring 3.2.0).
- The new asBool()/asNumber()/discard() traversal steps (and asBool()/
asNumber() in provider gremlin-semantics) lacked summaries, so they
attached silently to a neighbor page with no llms.txt entry. Added
summaries so each becomes its own discoverable Markdown page.
bin/process-docs.sh --dryRun now builds successfully with the --strict
Markdown split passing.
Assisted-by: Claude:claude-opus-4-8 [Claude Code]
---
docs/src/dev/provider/gremlin-semantics.asciidoc | 2 ++
docs/src/reference/the-traversal.asciidoc | 3 +++
docs/src/upgrade/release-3.8.0.asciidoc | 2 ++
docs/src/upgrade/release-3.8.1.asciidoc | 1 +
docs/src/upgrade/release-3.8.2.asciidoc | 1 +
5 files changed, 9 insertions(+)
diff --git a/docs/src/dev/provider/gremlin-semantics.asciidoc
b/docs/src/dev/provider/gremlin-semantics.asciidoc
index bced422437..a881971c38 100644
--- a/docs/src/dev/provider/gremlin-semantics.asciidoc
+++ b/docs/src/dev/provider/gremlin-semantics.asciidoc
@@ -758,6 +758,7 @@ None
See:
link:https://github.com/apache/tinkerpop/tree/x.y.z/gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.java[source],
link:https://tinkerpop.apache.org/docs/x.y.z/reference/#as-step[reference]
+[llms-summary="The formal semantics of the asBool() step: parses the value of
the incoming traverser as a boolean."]
[[asBool-step]]
=== asBool()
@@ -811,6 +812,7 @@ Incoming date remains unchanged.
See:
link:https://github.com/apache/tinkerpop/tree/x.y.z/gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/step/map/AsDateStep.java[source],
link:https://tinkerpop.apache.org/docs/x.y.z/reference/#asDate-step[reference]
+[llms-summary="The formal semantics of the asNumber() step: converts the
incoming traverser to the nearest parsable type, or to the desired numerical
type based on the GType type token provided."]
[[asNumber-step]]
=== asNumber()
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index 6b979c286d..d52129ad0d 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -808,6 +808,7 @@
g.V().hasLabel('person').values('age').fold().asString(local) <3>
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#asString()++[`asString()`]
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#asString(org.apache.tinkerpop.gremlin.process.traversal.Scope)++[`asString(Scope)`]
+[llms-summary="The asBool()-step (map) converts the incoming traverser to a
boolean value."]
[[asBool-step]]
=== AsBool Step
@@ -857,6 +858,7 @@ g.inject(datetime("2023-08-24T00:00:00Z")).asDate() <3>
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#asDate()++[`asDate()`]
+[llms-summary="The asNumber()-step (map) converts the incoming traverser to
the nearest parsable numerical type, or to the numerical type named by a GType
token."]
[[asNumber-step]]
=== AsNumber Step
@@ -1686,6 +1688,7 @@
g.V().values("name").fold().difference(__.V().limit(2).values("name").fold())
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#difference(java.lang.Object)++[`difference(Object)`]
link:++https://tinkerpop.apache.org/docs/x.y.z/dev/provider/#difference-step++[`Semantics`]
+[llms-summary="The discard()-step (filter) filters all objects from a
traversal stream, useful for throwing away traversers in a particular branch of
code."]
[[discard-step]]
=== Discard Step
diff --git a/docs/src/upgrade/release-3.8.0.asciidoc
b/docs/src/upgrade/release-3.8.0.asciidoc
index 778b0045ef..fc01afa80b 100644
--- a/docs/src/upgrade/release-3.8.0.asciidoc
+++ b/docs/src/upgrade/release-3.8.0.asciidoc
@@ -16,6 +16,7 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
////
+[llms-summary="Upgrade notes for the TinkerPop 3.8.0 release: breaking changes
and new features for users, including standardized local/global scoping,
simplified grammar, more consistent step behavior, new type-conversion and
type-testing steps, and initial Model Context Protocol (MCP)
support.",allow-oversize="true"]
== TinkerPop 3.8.0
*Release Date: November 12, 2025*
@@ -1555,6 +1556,7 @@ to continue to refine this `Channelizer` implementation,
and it can be deprecate
See: link:https://issues.apache.org/jira/browse/TINKERPOP-3168[TINKERPOP-3168]
+[llms-summary="Provider-facing upgrade notes for TinkerPop 3.8.0: changes
graph system and graph driver providers must account for, including custom type
registration in the GlobalTypeCache and type-comparison support."]
=== Upgrading for Providers
==== Graph System Providers
diff --git a/docs/src/upgrade/release-3.8.1.asciidoc
b/docs/src/upgrade/release-3.8.1.asciidoc
index 23cde06365..11a3f9a896 100644
--- a/docs/src/upgrade/release-3.8.1.asciidoc
+++ b/docs/src/upgrade/release-3.8.1.asciidoc
@@ -16,6 +16,7 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
////
+[llms-summary="Upgrade notes for the TinkerPop 3.8.1 release: Gremlint
formatting through the Gremlin MCP server and other changes for users and
providers."]
== TinkerPop 3.8.1
*Release Date: April 1, 2026*
diff --git a/docs/src/upgrade/release-3.8.2.asciidoc
b/docs/src/upgrade/release-3.8.2.asciidoc
index e602fa0335..2b8ffbd336 100644
--- a/docs/src/upgrade/release-3.8.2.asciidoc
+++ b/docs/src/upgrade/release-3.8.2.asciidoc
@@ -16,6 +16,7 @@ KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
////
+[llms-summary="Upgrade notes for the TinkerPop 3.8.2 release: experimental JDK
21 and JDK 25 support and other changes."]
== TinkerPop 3.8.2
*Release Date: NOT OFFICIALLY RELEASED YET*
