Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .openpublishing.redirection.core.json
Original file line number Diff line number Diff line change
Expand Up @@ -1707,6 +1707,10 @@
"source_path_from_root": "/docs/core/tools/csproj.md",
"redirect_url": "/dotnet/core/project-sdk/msbuild-props"
},
{
"source_path_from_root": "/docs/core/tools/custom-templates.md",
"redirect_url": "/dotnet/core/tools/templates"
},
{
"source_path_from_root": "/docs/core/tools/dotnet-add-package.md",
"redirect_url": "/dotnet/core/tools/dotnet-package-add"
Expand Down
325 changes: 0 additions & 325 deletions docs/core/tools/custom-templates.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-details.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,4 @@ If the package is installed locally or is found on the official NuGet website, i
- [dotnet new uninstall command](dotnet-new-uninstall.md)
- [dotnet new list command](dotnet-new-list.md)
- [dotnet new search command](dotnet-new-search.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,4 +100,4 @@ Starting with .NET SDK 6.0.100, installed template packages are available in lat

- [`dotnet new` command](dotnet-new.md)
- [`dotnet new search` command](dotnet-new-search.md)
- [Custom templates for `dotnet new`](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,4 +148,4 @@ Starting with .NET SDK 7.0.100, the `list` command might not show all the templa

- [dotnet new command](dotnet-new.md)
- [dotnet new search command](dotnet-new-search.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-sdk-templates.md
Original file line number Diff line number Diff line change
Expand Up @@ -1006,6 +1006,6 @@ The following table shows templates that have been discontinued and no longer co

- [dotnet new command](dotnet-new.md)
- [dotnet new list command](dotnet-new-list.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
- [Create a custom template for dotnet new](../tutorials/cli-templates-create-item-template.md)
- [Implicit using directives](../project-sdk/overview.md#implicit-using-directives)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -130,4 +130,4 @@ The `dotnet new search` command searches for templates supported by `dotnet new`

- [dotnet new command](dotnet-new.md)
- [dotnet new list command](dotnet-new-list.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-uninstall.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,4 +74,4 @@ The `dotnet new uninstall` command uninstalls a template package at the `PATH` o
- [dotnet new command](dotnet-new.md)
- [dotnet new list command](dotnet-new-list.md)
- [dotnet new search command](dotnet-new-search.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,4 +85,4 @@ The `dotnet new update` command with `--check-only` option checks for available
- [dotnet new command](dotnet-new.md)
- [dotnet new search command](dotnet-new-search.md)
- [dotnet new install command](dotnet-new-install.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
2 changes: 1 addition & 1 deletion docs/core/tools/dotnet-new.md
Original file line number Diff line number Diff line change
Expand Up @@ -160,5 +160,5 @@ Each template may have additional options defined. For more information, see [.N
- [dotnet new search command](dotnet-new-search.md)
- [dotnet new install command](dotnet-new-install.md)
- [.NET default templates for dotnet new](dotnet-new-sdk-templates.md)
- [Custom templates for dotnet new](custom-templates.md)
- [.NET templates overview](templates.md)
- [Create a custom template for dotnet new](../tutorials/cli-templates-create-item-template.md)
293 changes: 293 additions & 0 deletions docs/core/tools/templates.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ In the second group, the `<TargetFramework>` setting ensures that MSBuild runs p
`<ItemGroup>` contains two items. First, the `<Content>` item includes everything in the _templates_ folder as content. It's also set to exclude any _bin_ folder or _obj_ folder to prevent any compiled code (if you tested and compiled your templates) from being included. Second, the `<Compile>` item excludes all code files from compiling no matter where they're located. This setting prevents the project that's used to create the template package from trying to compile the code in the _templates_ folder hierarchy.

> [!TIP]
> For more information about NuGet metadata settings, see [Pack a template into a NuGet package (nupkg file)](../tools/custom-templates.md#pack-a-template-into-a-nuget-package-nupkg-file).
> For more information about NuGet metadata settings, see [Template packages](../tools/templates.md#template-packages).

The created project file includes [template authoring MSBuild tasks](https://aka.ms/templating-authoring-tools) and localization settings.

Expand Down Expand Up @@ -209,7 +209,7 @@ Congratulations! You've installed and uninstalled a template package.

## Next steps

To learn more about templates, most of which you've already learned, see the [Custom templates for dotnet new](../tools/custom-templates.md) article.
To learn more about templates, see [.NET templates overview](../tools/templates.md).

* [Template Authoring Tools](https://aka.ms/templating-authoring-tools)
* [dotnet/templating GitHub repo Wiki](https://github.com/dotnet/templating/wiki)
Expand Down
4 changes: 2 additions & 2 deletions docs/navigate/tools-diagnostics/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -150,8 +150,8 @@ items:
href: ../../core/tools/dotnet-new-update.md
- name: .NET default templates
href: ../../core/tools/dotnet-new-sdk-templates.md
- name: Custom templates
href: ../../core/tools/custom-templates.md
- name: .NET templates overview

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the overview should come before the default templates article.

@adegeo adegeo Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm indifferent, it's reference material, as is the CLI help above it. Personally I don't much like any of these articles placed here, but I don't own the area.

href: ../../core/tools/templates.md
- name: dotnet nuget
items:
- name: dotnet nuget delete
Expand Down
Loading