Aspnetcore.docs: Dozen of blazor dotnet command doesn't work if we are using a latest listed Microsoft.AspNetCore.Blazor.Templates package

Created on 18 Mar 2020  路  3Comments  路  Source: dotnet/AspNetCore.Docs

All of the authentication commands (standalone) in docs doesn't work if we don't specifically follow get started page of the docs in which it is stated that 3.2.0-preview2.20160.5 should be used.
However, it doesn't make sense to go through all the documentation each and every time you want to update your project so please list this version on nuget.org. You'll save people a lot of time.

Blazor Source - Docs.ms doc-enhancement product-question

All 3 comments

Hello @tomidix ... I hear you on that. They don't know the version number for a preview release until they get to the release. It's just one of those little things that devs have to deal with during this period. The good news is that Blazor WebAssembly will be an officially released product in a few months. After that, you won't need to do the separate template install step.

@mkArtakMSFT can comment on why the latest version of the package isn't listed in NuGet. Do we need to address it in any way in the Get Started topic? ... e.g., mention to readers that it won't be seen there.

https://www.nuget.org/packages/Microsoft.AspNetCore.Blazor.Templates/

I thought this would be the case so that's why I wrote just to list this specific version.

If there is a specific reason why it's not listed then it would be nice if the standalone auth documentation pages could have the requirements changed too.. specific template version should be mentioned there as I red this and thought that I'm satisfying the requirements:
_The guidance in this article applies to the ASP.NET Core Blazor WebAssembly template version 3.2 or later. To obtain the latest Blazor WebAssembly template, see Get started with ASP.NET Core Blazor._

specific template version should be mentioned there

We do have the Blazor WebAsssembly notes in INCLUDE files for all of the topics ...

The article note is ...

[!NOTE]
The guidance in this article applies to the ASP.NET Core Blazor WebAssembly template version 3.2 or later. To obtain the latest Blazor WebAssembly template, see .

The section note is ...

[!NOTE]
The guidance in this section applies to the ASP.NET Core Blazor WebAssembly template version 3.2 or later. To obtain the latest Blazor WebAssembly template, see .

Those could include the template version.

Then, I only need to update two files to update the version everywhere each pre-release. That would be easy, and it would only be temporary. Of course, the NOTE INCLUDE files will be deleted when Blazor WebAssembly reaches its first regular release.

~@mkArtakMSFT, I like the idea, does it sound good to you?~ It's quick and low-hanging 馃崕 to do ... I'll go ahead and put the PR up for review.

Was this page helpful?
0 / 5 - 0 ratings