[Theme Handbook Overhaul] Publish Chapter 4: Templates

[justintadlock]

Now that the Templates chapter is fully drafted, it is time to begin moving this new chapter to the Theme Handbook, at least once the Global Settings and Styles chapter (#1131) is live.

This is a sub-tracking issue for #816. I've created this ticket so that it's easier to manage and coordinate the process for this new chapter that is being added. We can also use this to add any notes for things we need to know as we move through the larger Theme Handbook Overhaul project.

When publishing this chapter, there are two related docs from Global Settings and Styles that also need to be published, so this ticket is broken into two sections.

Docs to publish/update

Publish under the Global Settings and Styles chapter:

• [Theme Handbook Overhaul] Global Settings and Styles > Custom Templates #1113
• [Theme Handbook Overhaul] Global Settings and Styles > Template Parts #1116

Update under the Global Settings and Styles chapter:

These need the links to the above template-related docs re-added.

• [Theme Handbook Overhaul] Global Settings and Styles > Chapter Landing Page #1123
• [Theme Handbook Overhaul] Global Settings and Styles > Introduction to theme.json #1122

Publish under the Templates chapter:

• [Theme Handbook Overhaul] Templates > Chapter Landing Page #1125
• [Theme Handbook Overhaul] Templates > Introduction to templates #1126
• [Theme Handbook Overhaul] Templates > Templates #1128
• [Theme Handbook Overhaul] Templates > Template Hierarchy #1132
• [Theme Handbook Overhaul] Templates > Template Parts #1130

Older Content

This new chapter is replacement for these articles in the current handbook:

• https://developer.wordpress.org/themes/block-themes/templates-and-template-parts/

There is no current decision on how to handle older content. My recommendation for this is:

• Remove the current doc from the navigation but leave published.
• Replace the current doc's content with an Notice block that points readers to the new chapter at https://developer.wordpress.org/themes/templates.

Example content for the Notice block:

This article has now been replaced with a dedicated Templates chapter in the Theme Handbook.

[github-actions]

Heads up @kafleg @carolinan @TeBenachi - the "themes" label was applied to this issue.

[github-actions]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

[justintadlock]

All of the docs for this chapter have now been moved to the Theme Handbook as drafts. I'll go through and publish these once I get the 👍 and do any final link checks.

[justintadlock]

This chapter is now published in the Theme Handbook: https://developer.wordpress.org/themes/templates/

Let's leave this ticket open for a bit to track any issues. The question of what to do with older/existing content remains open.