Skip to content

https://aka.ms/dotnet-install-templates has bad redirect + No "Install templates docs" #3178

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
3 tasks
rachelappel opened this issue Sep 19, 2017 · 6 comments
Closed
3 tasks
Labels
won't fix Issues that were closed as part of automated backlog grooming

Comments

@rachelappel
Copy link

rachelappel commented Sep 19, 2017

Originally opened by @shanselman at dotnet/AspNetCore.Docs#4018
Asked to move here per @danroth27

With SDKs backward compatible (without global.json) it possible to create a .NET Core 1.1 application by using the new version, such as
dotnet new console --framework netcoreapp1.1
This returns with an error that this is not a valid value for –framework and a link to install additional templates: https://aka.ms/dotnet-install-templates
It would be ideal if this link showed how to install a template for .NET Core 1.1 with the the .NET Core 2.0 SDK as well as the general "how to install templates" topic.
However, this aka link redirects to Introduction to ASP.NET Core: https://docs.microsoft.com/en-us/aspnet/core/

I see a few to-dos here:

/cc @mlorbetske @RickAndMSFT

From Mike, some starter text:

To install the 1.0 and 1.1 project templates, please run one or more of the following commands

For web templates:
dotnet new -i Microsoft.DotNet.Web.ProjectTemplates.1.x::1.0.0-*

For class library or console apps:
dotnet new -i Microsoft.DotNet.Common.ProjectTemplates.1.x::1.0.0-*

For unit test projects:
dotnet new -i Microsoft.DotNet.Test.ProjectTemplates.1.x::1.0.0-*

@mlorbetske
Copy link

cc @sayedihashimi

@mairaw
Copy link
Contributor

mairaw commented Sep 19, 2017

@sayedihashimi for some reason I can't find that aka.ms link in the tool even though I should have permissions (since when I tried to create it again, it tells me that you and ddfwlink are the owners). It seems that since that issue was created for aspnet/docs, you created a help topic in one of the repos and changed the aka.ms link to that.

We already have a topic that covers custom templates, including installation:
https://docs.microsoft.com/en-us/dotnet/core/tools/custom-templates#installing-a-template

Should I just update that topic to include that info and then we change aka.ms link and delete that other topic?

@sayedihashimi
Copy link
Member

@mairaw the end-user will see this error whenever they try to invoke a template which is not installed. One very common case of that is a user trying to create a 1.1 project after installing 2.0. In that case the linked doc is not very helpful. I'd like to link to a page which includes that info since it will be a common case when visiting the link.

@mairaw
Copy link
Contributor

mairaw commented Sep 19, 2017

@sayedihashimi yep, I understand that. What I was proposing is to add that info to that existing doc. Do you agree with that?

@sayedihashimi
Copy link
Member

Sounds good

@dotnet-bot dotnet-bot added the won't fix Issues that were closed as part of automated backlog grooming label Jan 25, 2021
@dotnet-bot
Copy link
Contributor

This issue has been closed as part of the issue backlog grooming process outlined in #22351.

That automated process may have closed some issues that should be addressed. If you think this is one of them, reopen it with a comment explaining why. Tag the @dotnet/docs team for visibility.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
won't fix Issues that were closed as part of automated backlog grooming
Projects
None yet
Development

No branches or pull requests

9 participants