Fix container tags comments

[sebastienros]

Description

Some changes that were done in release/9.0 were not merged back to main due to conflicts. This is fixing it. This should supersede https://github.com/dotnet/aspire/pull/6718 which was opting to point to the <summary/> tag instead, but this would be opposite to what we have in release/9.0.

Fixes # (issue)

Checklist

• Is this feature complete?
  • [x] Yes. Ready to ship.
  • [ ] No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • [ ] Yes
  • [x] No
• Did you add public API?
  • [ ] Yes
  • If yes, did you have an API Review for it?
    • [ ] Yes
    • [ ] No
  • Did you add <remarks /> and <code /> elements on your triple slash comments?
    • [ ] Yes
    • [ ] No
  • [x] No
• Does the change make any security assumptions or guarantees?
  • [ ] Yes
  • If yes, have you done a threat model and had a security review?
    • [ ] Yes
    • [ ] No
  • [x] No

• Does the change require an update in our Aspire docs?

  • [ ] Yes
  • Is this introducing a breaking change?
    • [ ] Yes
    • Link to aspire-docs issue (please use this breaking-change template):
    • [ ] No
    • Link to aspire-docs issue (please use this doc-idea template):
  • [x] No

  Microsoft Reviewers: Open in CodeFlow

[sebastienros]

@eerhardt I couldn't understand some of your comments on the other PR, like https://github.com/dotnet/aspire/pull/6718#issuecomment-2483835343 and https://github.com/dotnet/aspire/pull/6718#issuecomment-2483827603. I don't any issue with these.

[eerhardt]

@eerhardt I couldn't understand some of your comments on the other PR, like #6718 (comment) and #6718 (comment). I don't any issue with these.

For the comment (Although, that EventHubs one appears misplaced. It should be on the RunAsEmulator method.) I've pushed an update to this PR to move the remarks to the correct method. The 3 I pointed to weren't updated in #6718. But they are updated here now (using the other way).

For the 2 in AzureOpenAIDeployment - you can see on the docs site that it isn't working:

https://learn.microsoft.com/en-us/dotnet/api/aspire.hosting.applicationmodel.azureopenaideployment.skuname?view=dotnet-aspire-9.0

[sebastienros]

Thanks. The missing resolution in the docs site is probably something to fix in the docs generation, and if we can't then we may want to change this in the code and remove these substitutions.

I checked for the tags and they don't work either, assuming that the docs are based on release/9.0 and not main.

@IEvangelist do you think there is a possibility this gets fixed in the docs.