compose: improving suggestion messages around azd infra synth

[JeffreyCA]

This is kind of a sub-issue to #4578, and may be irrelevant depending on how we'll support "hybrid IaC", so feel free to close this if that's the case.

Currently, if you add a new resource using azd add to an azd project that already has an infra folder, the following message is shown to the user after accepting the changes to azure.yaml:

Run 'azd infra synth' to re-synthesize the infrastructure, then run 'azd provision' to provision these changes anytime later.

From my own experience encountering this message for the first time, I didn't really know what terms like "re-synthesize the infrastructure" or "overwrite with the synthesized versions" meant at first (I later learned these were common terminology used in IaC, Terraform, AWS CDK):

I found the description used in the help text for azd infra synth to be more helpful:

Available Commands
  synth : Write IaC for your project to disk, allowing you to manage it by hand. (Beta)

Do you think instead of "re-synthesize the infrastructure" we could have similar wording to above? I think new users, especially those unfamiliar with IaC/Terraform lingo could benefit.

[weikanglim]

Just curious, @JeffreyCA, in your mind, does "generate" sound better here?

[JeffreyCA]

Just curious, @JeffreyCA, in your mind, does "generate" sound better here?

Yes, "generate" sounds better to me, and maybe also that these are infrastructure files (on disk)