iam-role documentation is rubbish

[chrisbecke]

Description

The docs/UPGRADE-6.0.md document clearly states that multiple iam-*-role modules have been merged into a single iam-role sub module.

But the first thing people see is https://github.com/terraform-aws-modules/terraform-aws-iam/blob/v6.2.1/modules/iam-role/README.md in which

starts with

Creates a single IAM role which can be assumed by trusted resources using OpenID connect federation.

I hope it does more than only support OIDC federation, and then goes into a "Usage" section which

Immediately references "terraform-aws-modules/iam/aws//modules/iam-oidc-role" which is not valid.

Has a section titled something which might actually be the documentation I am looking for but who can tell.

I dont know if any of the inputs or outputs documentation can be trusted given the state of the Usage section and going to the examples/ folder for samples of how to create the equiavalent of an iam-assumable-role (for example) is no help.