docs: document workflow token behaviors #2500
Description
Assumptions that bolt makes around workflow token and how they are used is not documented, this can lead to some confusion. I think we should document that whenever a workflow token is found in an event payload it will be used by the client injected into the handler. It is also worth documenting that this behavior can be disabled with attachFunctionToken = false
List any relevant URLs
Requirements
Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you are agreeing to those rules.