He-Pin opened a new pull request, #2811:
URL: https://github.com/apache/pekko/pull/2811

   ## Motivation
   
   The `fromTry` and `fromTryKeepException` methods have Scaladoc that does not 
clearly explain the serialization trade-offs between the two approaches. Users 
may not realize that `fromTryKeepException` requires configured serializers for 
remote actors.
   
   ## Modification
   
   Enhanced Scaladoc for both methods:
   - `fromTry`: Explicitly states why string-based errors are safe for remote 
actors.
   - `fromTryKeepException`: Clarifies that serializers must be configured for 
exception types, and when to prefer each method.
   
   Also includes `@since 2.0.0` annotations (overlaps with 
improve/statusreply-since branch — if that merges first, these annotations 
would already be present).
   
   ## Result
   
   Clearer API documentation that helps users make informed decisions about 
error handling in distributed systems.
   
   ## References
   
   - Follow-up improvement to #2796 (StatusReply.fromTry factories).
   - Addresses serialization concerns common in distributed actor systems.


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


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to