dotnet / aspnetcore

ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.
https://asp.net
MIT License
35.37k stars 9.99k forks source link

Consolidate Blazor Web App terminology: "Interactive render mode" vs "Interactivity type" vs "hosting model" #51108

Closed danroth27 closed 1 year ago

danroth27 commented 1 year ago

In .NET 8 we introduced the concept of interactive render modes in the Blazor framework:

In the Blazor Web App project template we refer to "Interactivity type" in the VS UI:

blazor-web-app-interactivity-type

And in the command-line help for the Blazor Web App template we refer to "hosting platform":

 -int, --interactivity <None|Server|...>  Chooses which hosting platform to use for interactive components
                                           Type: choice
                                             None         No interactivity (static server rendering only)
                                             Server       Runs on the server
                                             WebAssembly  Runs in the browser using WebAssembly
                                             Auto         Uses Server while downloading WebAssembly assets, then uses WebAssembly

To consolidate the terminology, I recommend the following:

marinasundstrom commented 1 year ago

Great!

What people would perceive as the hosting platform for a Blazor Web App would probably be Server by default - as the main project is Server. So it's good to get rid of that other usage.

It's the render modes that are different, and the choice is whether the developer wants to include components that demonstrate those render modes, or not.