Update Swashbuckle link

[guardrex]

Fixes #561

Would you be able to make it redirect to the net 9 docs instead?

Thanks @DevTKSS! 🚀

cc: @BethMassi ... Recommend that you change the underlying link for https://aka.ms/aspnetcore/swashbuckle to not point at the 8.0 version of the article. At least for now, my fix is merely to place the absolute URL of the doc here without an article version.

[BethMassi]

@guardrex the destination link doesn't specify a version: https://learn.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle

[guardrex]

@BethMassi Ah! I see. Swashbuckle isn't available in .NET 9 or later. I only looked at the version selector and noticed it at "8.0" when I loaded the article.

I'll revert this! Sorry for my confusion on this one! 🙈😆

[DevTKSS]

@guardrex looked to me reading the docs md files, as if this problem might be caused by a xref link on that top Box 🤔
you do have a Include in this file here:

• https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/getting-started-with-swashbuckle.md?plain=1
  which is including this linked here:
• https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md?plain=1
  and this is the link to the new docs:
  https://github.com/dotnet/AspNetCore.Docs/blob/6a01f804a5997b59b30c51cf56c834782c229625/aspnetcore/tutorials/getting-started-with-swashbuckle/includes/getting-started-with-swashbuckle8.md?plain=1#L5

and this is what the "Asp Net Core Web API" net 8 asp net core template is providing to me, as-is from MS

So in my opinion, as this is proposing that we would get Swagger != Swashbuckle (?) which is up from net9 still this code there:

and this is also still the same provided (except from the Version of course):

Maybe that name of the aka link, the postfix there, should be updated to "swagger"? even in the currently as STS provided net8 templates?

I mean... The comment is essentially advertising, that we would use Swagger/OpenAPI but the argument now is, while we still use that same, thats something different? well at least thats strange 🤔 just my opinion.

but its your decision 👍

[guardrex]

They converted over to OpenAPI for the web API project template ...

https://github.com/dotnet/aspnetcore/blob/main/src/ProjectTemplates/Web.ProjectTemplates/content/WebApi-CSharp/Program.cs#L49-L50

... and we'll do the same here. I've opened #564 to work on it.