Rewrite "custom templates" to an overview article.

[adegeo]

Rewrote the custom templates article to be an overview about templates and about how they're structured.

• Removed the word "custom" as that doesn't mean anything. Templates are templates. There's no "custom" template. You can, however, make your own...
• Basic info about how templates are structured, configured, customized
• Basic info about how to install/remove templates.

Fixes #51380

---

Internal previews

Toggle expand/collapse

File	Preview link
.openpublishing.redirection.core.json	.openpublishing.redirection.core.json
docs/core/tools/dotnet-new-details.md	docs/core/tools/dotnet-new-details
docs/core/tools/dotnet-new-install.md	docs/core/tools/dotnet-new-install
docs/core/tools/dotnet-new-list.md	docs/core/tools/dotnet-new-list
docs/core/tools/dotnet-new-sdk-templates.md	docs/core/tools/dotnet-new-sdk-templates
docs/core/tools/dotnet-new-search.md	docs/core/tools/dotnet-new-search
docs/core/tools/dotnet-new-uninstall.md	docs/core/tools/dotnet-new-uninstall
docs/core/tools/dotnet-new-update.md	docs/core/tools/dotnet-new-update
docs/core/tools/dotnet-new.md	docs/core/tools/dotnet-new
docs/core/tools/templates.md	docs/core/tools/templates
docs/core/tutorials/cli-templates-create-template-package.md	docs/core/tutorials/cli-templates-create-template-package
docs/navigate/tools-diagnostics/toc.yml	docs/navigate/tools-diagnostics/toc

[Copilot]

Pull request overview

This PR replaces the older “custom templates” article with a new overview article that explains how .NET templates work and updates navigation, cross-links, and redirects so readers land on the new content.

Changes:

• Adds a new .NET templates overview article (templates.md) covering template types, structure, packages, installation, localization, and Visual Studio integration.
• Updates TOC entries and “See also/Next steps” links across dotnet new docs and the template packaging tutorial to point to the new overview.
• Deletes custom-templates.md and adds a redirect from /docs/core/tools/custom-templates.md to /dotnet/core/tools/templates.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
docs/navigate/tools-diagnostics/toc.yml	Updates navigation entry to point from the removed custom-templates page to the new templates overview.
docs/core/tutorials/cli-templates-create-template-package.md	Repoints references to the new overview article and its “Template packages” section.
docs/core/tools/templates.md	Introduces the new templates overview article that replaces the removed custom-templates page.
docs/core/tools/dotnet-new.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-update.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-uninstall.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-search.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-sdk-templates.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-list.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-install.md	Updates related links to reference the new templates overview article.
docs/core/tools/dotnet-new-details.md	Updates related links to reference the new templates overview article.
docs/core/tools/custom-templates.md	Removes the outdated custom-templates article in favor of the new overview + redirect.
.openpublishing.redirection.core.json	Adds a redirect so existing links to custom-templates.md resolve to the new templates overview page.

Comments suppressed due to low confidence (1)

docs/core/tools/templates.md:278

• The style guide requires no spaces around em dashes. Remove the spaces around the em dash in this sentence.

**Project and solution templates** appear in the **Create a new project** dialog alongside the built-in SDK templates. Users can find your template by name, language, or by the tags from the `classifications` field in `template.json`. Accurate classifications help your template surface in the right filter categories, so choose them carefully. To give your template a polished appearance in the dialog, add an `icon.png` to the `.template.config` folder — Visual Studio displays it next to your template's name.

[gewarren]

To me the new templates article is a bit confused about its audience - a lot of it seems written to template creators, which is probably just a small percentage of readers, so I think "Template overview" is not the best title.