[Bug]: `linode.cloud.instance` module documentation is out of date and/or incorrect

[AllRWeak]

Ansible Version

ansible [core 2.19.4]

Ansible Configuration

linode.cloud collection version 0.43.0

Effected Components

No response

Expected Behavior

When going through the documentation on how to configure an VPC interface I'd expect the documentation to be correct - https://github.com/linode/ansible_linode/blob/main/docs/modules/instance.md#interfaces

Actual Behavior

The documentation is out of date or incorrect. The examples show one thing and parameters a different one none of them give the actual result. Going through the documentation I tried to configure a VPC interface for an instance but kept getting different errors inconsistent to what the documentation says I should do.

Steps to Reproduce

Using the linode.cloud.instance try to create a new instance with the interfaces list defined below (replace the subnet_id and address accordingly).

interfaces:
  - purpose: vpc
    primary: true
    subnet_id: 12345
    label: interface_label_1
    ipv4:
      addresses:
        - address: 10.0.0.10
          nat_1_1_address: auto
          primary: true

The documentation says these parameters should work but I get an error:

    msg: 'Unsupported parameters for (linode.cloud.instance) module: interfaces.ipv4.addresses.
        Supported parameters include: nat_1_1, vpc.'

I also tried different methods based on the error messages or using the linode_interfaces parameters but with with no luck.

Please update the documentation on how to configure VPC interfaces when creating a new instance.