crossplane / upjet

A code generation framework and runtime for Crossplane providers
Apache License 2.0
322 stars 90 forks source link

Extend Marketplace documents with external-name syntax #162

Open ezgidemirel opened 2 years ago

ezgidemirel commented 2 years ago

What problem are you facing?

Currently, users cannot find the external-name annotation syntax before actually creating a resource. We can add a new section to the marketplace like Terraform registry's import and provide that information. This can be especially useful in import and migration scenarios. More context can be found here.

How could Official Providers help solve your problem?

Automatically generate external-name annotation syntax for marketplace documentation.

ulucinar commented 2 years ago

For some providers, Terraform registry has consistent "import statement" documentation (which we used to determine most group names for resources). One idea could be to use that metadata for automatically extracting the docs mentioned here.