spmallette commented on code in PR #3121: URL: https://github.com/apache/tinkerpop/pull/3121#discussion_r2108930002
########## docs/src/upgrade/release-3.8.x.asciidoc: ########## @@ -30,6 +30,11 @@ complete list of all the modifications that are part of this release. === Upgrading for Users +==== Auto promotion of number types + +Any math operations such as Add, Sub, Mul & Div will automatically promote to next number type if an overflow is detected. For integers the promotion sequence is byte->short->integer->long->overflow exception. For floating point the sequence is float->double->infinity. Review Comment: I think we need more clarity here as I don't think users will follow this as it is written. User think in terms of steps with Gremlin so I think this needs to start by referencing the problem in terms of the steps affected. Then, explain the solution. Use examples. Reference the JIRA and supporting documentation. -- 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]
