[Theme Handbook Overhaul] Publish Chapter 1: Getting Started and Chapter 2: Core Concepts

[justintadlock]

Now that the Getting Started and Core Concepts chapters are drafted, it is time to begin moving them to the Theme Handbook. These two chapters should be published at the same time because there is a lot of cross-linking between the two.

These chapters must wait until Chapter 5: Features (#1256) is published before moving forward to avoid broken links.

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.

Docs to publish

Publish under the Getting Started chapter:

• [Theme Handbook Overhaul] Getting Started > Chapter Landing Page #1257
• [Theme Handbook Overhaul] Getting Started > What is a theme? #841
• [Theme Handbook Overhaul] Getting Started > Who is this handbook for? #845
• [Theme Handbook Overhaul] Getting Started > Reading this handbook #847
• [Theme Handbook Overhaul] Getting Started > Tools and setup #852
• [Theme Handbook Overhaul] Getting Started > Quick-start guide #878

Publish under the Core Concepts chapter:

• [Theme Handbook Overhaul] Core Concepts > Chapter Landing Page #1258
• [Theme Handbook Overhaul] Core Concepts > Theme Structure #920
• [Theme Handbook Overhaul] Core Concepts > Main Stylesheet #921
• [Theme Handbook Overhaul] Core Concepts > Templates #930
• [Theme Handbook Overhaul] Core Concepts > Custom Functionality #969
• [Theme Handbook Overhaul] Core Concepts > Including Assets #984
• [Theme Handbook Overhaul] Core Concepts > Global Settings and Styles #989

Older content to update

• The new Getting Started chapter is meant to be a wholesale replacement of the existing Getting Started chapter.
• The new Core Concepts chapter is meant to be a wholesale replacement of the existing Theme Basics chapter.
• Chapters 1-5 would also replace the existing Block Themes chapter, with the exception of the Converting a classic theme to a block theme section, which should be moved under an eventual Guides chapter.

[github-actions]

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

[github-actions]

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

[justintadlock]

Chapter 1 drafts are now moved from Google Docs to drafts in the Theme Handbook, with the exception of #1257 and #841. Those will replace existing pages, and I didn't want to mess those up until we published.

Note that some screenshots now have the Twenty Twenty-Four theme, which won't be available until WordPress 6.4 on Nov. 7, 2023.

I'll get to work on Chapter 2 soon.

[justintadlock]

Most of Chapter 2 is now drafted in the Theme Handbook. I still have the Including Assets and Global Settings and Styles docs left, which I'll pick up next week.

[justintadlock]

Both Chapter 1: Getting Started and Chapter 2: Core Concepts are drafted in the Theme Handbook. These can now be published with approval from the handbook reps (after WordPress 6.4 is released).

[kafleg]

I will check when I will get time.

[kafleg]

@justintadlock I just went to all the drafts and checked them. All of them LGTM.

[justintadlock]

Thanks, @kafleg. I'll go through any notes in the tickets and get these published today.

[justintadlock]

Both of these chapters are now live with updated/new content:

• https://developer.wordpress.org/themes/getting-started/
• https://developer.wordpress.org/themes/core-concepts/

I'll leave this ticket open for a bit for bug reports and working through old content updates.

[bacoords]

Great work! Minor error on the theme structure page under Required Files. You say There are three necessary files but then only list two files, index.html and style.css.

[justintadlock]

Great work! Minor error on the theme structure page under Required Files. You say There are three necessary files but then only list two files, index.html and style.css.

Good catch! Fixed. It's supposed to be just the two files listed.