[ Documentation request ] Java Workflows must not catch Throwables and DestroyWorkflowThreadError

[artemik]

Brief description

In Java SDK, thread yielding/release from user's workflow code works based on throwing DestroyWorkflowThreadError on Temporal library calls to break out of user's workflow code execution. It means user workflow code must not catch DestroyWorkflowThreadError/Error/Throwable. This is a crucial fact but is missing in documentation.

Even though common pattern for devs is to catch just Exception:

try {
    ...
} catch (Exception e) {
    ...
}

some prefer to catch Throwable, which would break Temporal.

Your recommended content

[fairlydurable]

Thank you for sending over this feedback. Do you have specific points in the documentation you can point me to where this error happens?