Allow appending doc notes to Resources and DataSources

[t0yv0]

Hello!

• Vote on this issue by adding a 👍 reaction
• If you want to implement this feature, comment to let us know (we'll work with you on design, scheduling, etc.)

Issue details

Motivated by pulumi/pulumi-digitalocean#445

Sometimes we have helpful information or notes to include with a given resource or datasource. Bridged providers maintainers have access to ResourceInfo.Docs of type tfbridge.DocInfo to customize documentation, but is very crude for this purpose. For example currently it is possible to override Markdown TF docs entirely, but it is inconvenient when adding a note since it wipes all argument documentation strings and existing useful information.

The suggestion is to extend DocInfo to permit adding Pulumi-specific annotations to the documentation.

Affected area/feature