andreachild commented on code in PR #3153:
URL: https://github.com/apache/tinkerpop/pull/3153#discussion_r2230151870


##########
docs/src/upgrade/release-3.8.x.asciidoc:
##########
@@ -30,6 +30,69 @@ complete list of all the modifications that are part of this 
release.
 
 === Upgrading for Users
 
+==== Number Conversion Step
+
+We have been iterative introducing new language features into Gremlin, with 
the last major set of string, list and date manipulation
+steps introduced in the 3.7 line. In 3.8.0, we are now introducing a number 
conversion step, `asNumber()`, to bridge
+a gap in casting functionalities.
+
+The new `asNumber()` serves as an umbrella step that parses strings and casts 
numbers into desired types. For the convenience of remote traversals in GLVs, 
these number types are denoted by a set of number tokens (`N`).
+
+This new step will allow users to normalize their data by converting string 
numbers and mixed numeric types to consistent format, making it easier to 
perform downstream mathematical operations. As an example:

Review Comment:
   ```suggestion
   This new step will allow users to normalize their data by converting string 
numbers and mixed numeric types to a consistent format, making it easier to 
perform downstream mathematical operations. As an example:
   ```



-- 
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]

Reply via email to