C++ interop: Wrap up the Swift 5.9 interop documentation

[hyp]

Description

The Swift 5.9 interop docs need to be updated:

• Reference counting issues should be outlined and mentioned there.
• updated build instructions
• framework client opt-in requirements

Additional information

No response

[fahadnayyar]

@hyp what is the meaning of "framework client opt-in requirements" ?