Document how functions can surface events/conditions on XRs/Claims

[jbw976]

What's Missing?

The ability for functions to bubble up events and status conditions to XR and/or claim was merged for v1.17 in crossplane/crossplane#5450.

As @dalton-hill-0 describes in crossplane/crossplane#4947 (comment), we now have:

• The ability for results to optionally emit events to the claim as well as the XR.
• The ability to set status conditions on the XR and optionally the claim.

This feature should be documented so the community can understand what it does and how they can start using it within their own functions.

[dalton-hill-0]

I identified a few spots to add this documentation. Please let me know what you think.

• Adding claim communication examples function-sdk-go#160
• Add Status Condition Example function-template-go#78
• Claim Communication Examples #809

cc: @jbw976 @negz

[jbw976]

https://github.com/crossplane-contrib/function-status-transformer is also related here ✅

[jbw976]

All the locations in @dalton-hill-0's list have been merged, so I'll go ahead and close this issue now. Thanks @dalton-hill-0! 🙇‍♂️