Route groups

[Rick-Anderson]

Route groups

Probably do this in multiple PR's

• Update this intro tutorial using sample code for a basic scenario
• sample code for more advanced scenarios
• Update Minimal APIs overview and What's new in ASP.NET Core 7.0

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: ab408035-6313-a183-9940-32de00e0e977
• Version Independent ID: ab408035-6313-a183-9940-32de00e0e977
• Content: Tutorial: Create a minimal web API with ASP.NET Core
• Content Source: aspnetcore/tutorials/min-web-api.md
• Product: aspnet-core
• Technology: aspnetcore-tutorials
• GitHub Login: @Rick-Anderson
• Microsoft Alias: riande

[Rick-Anderson]

@fiyazbinhasan once #26801 is approved, do you want to take the first check? Write the sample code?

[fiyazbinhasan]

Sure. I would like to do that :)

[fiyazbinhasan]

I think @tdykstra already started on this. Do let me know if you need a hand 😺

[tdykstra]

Yes I do! The MapGroup sample code I have in the intro tutorial is too basic for the what's new article. For the what's new I need an example that includes code similar to what we have in the Preview 4 blog post, i.e., code that illustrates what you can do with route groups in more advanced scenarios. This sample would ideally also include code that returns multiple result types from an endpoint.

[Rick-Anderson]

For the what's new I need an example that includes code similar to what we have in the Preview 4 blog post, i.e., code that illustrates what you can do with route groups in more advanced scenarios. This sample would ideally also include code that returns multiple result types from an endpoint.

Make sure that code makes it into a primary article, either Minimal APIs overview or better yet a new article under that.

What's new is the short version of what goes into primary articles with a link to the primary. When a new programmer starts .NET 9, she doesn't need to go to WN in .NET 7 to find features.

[Rick-Anderson]

@tdykstra @fiyazbinhasan and the sample should go in https://github.com/dotnet/AspNetCore.Docs.Samples

@tdykstra how much more do you need than what's in https://github.com/dotnet/AspNetCore.Docs.Samples/tree/main/fundamentals/minimal-apis/samples/MinApiTestsSample

[tdykstra]

how much more do you need

It's not ideal for showing what you can do with routes. The middleware code gets in the way of showing the MapVerb method calls, and the code doesn't illustrate this statement, which the blog code does:

It allows for customizing entire groups of endpoints with a single call to methods like RequireAuthorization() and WithMetadata().

[Rick-Anderson]

What I should have said is create an issue in https://github.com/dotnet/AspNetCore.Docs.Samples/issues and list what you need with the though that it could borrow much from the tests sample