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.