Usability: better documentation required for Instance instantiation/interaction with platform resources

[psychogenic]

Hello,

Creating instances to utilize 3rd party verilog/il modules was going rather well up to the point where one of them needed access to the raw pin, as it was instantiating an SB_IO directly and setting it as the PACKAGE_PIN.

Discovering how to actually pass in an
io_inoutpin = ...
on the instance proved rather difficult.
I finally turned to the libera chat, where whitequark indicated that
Instance("your_thing", io_whatever=platform.request("pin", dir="-").io)
would do the trick. That works fine.

So this "issue" is basically one of usability/documentation. There are no places (I could find) with any samples or this information explicitly stated and I think that would be useful.
Thanks.