[Theme Handbook Overhaul] Publish Chapter 3: Global Settings and Styles

[justintadlock]

Now that the Global Settings and Styles (theme.json) chapter is fully drafted, it is time to begin moving this new chapter to the Theme Handbook.

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 extremely large 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.

Note that this is the first chapter to be published, as outlined in Theme Handbook Overhaul: Phase 3 (Publishing Content). Chapters 1 and 2 rely on later chapters to be published first. Chapter 3 is the first self-contained chapter, which is why we are using it as a starting point.

Docs to publish

Each of these docs need to be added as drafts in the Theme Handbook. Then, when ready, publish them.

• [Theme Handbook Overhaul] Global Settings and Styles > Chapter Landing Page #1123
• [Theme Handbook Overhaul] Global Settings and Styles > Introduction to theme.json #1122
• [Theme Handbook Overhaul] Global Settings and Styles > Settings #1003
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Appearance Tools #1084
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Border #1049
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Color #1050
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Custom #1061
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Dimensions #1066
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Layout #1078
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Lightbox #1121
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Position #1099
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Shadow #1092
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Spacing #1093
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Typography #1108
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Use Root Padding Aware Alignments #1098
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Blocks #1111
  • [Theme Handbook Overhaul] Global Settings and Styles > Settings > Settings Reference #987
• [Theme Handbook Overhaul] Global Settings and Styles > Styles #1117
  • [Theme Handbook Overhaul] Global Settings and Styles > Styles > Applying Styles #1118
  • [Theme Handbook Overhaul] Global Settings and Styles > Styles > Using Presets #1119
  • [Theme Handbook Overhaul] Global Settings and Styles > Styles > Styles Reference #1120
• [Theme Handbook Overhaul] Global Settings and Styles > Patterns #1124
• [Theme Handbook Overhaul] Global Settings and Styles > Style Variations #1112

To be published with Chapter 4: Templates

Two of the docs drafted for this chapter should be published alongside the Templates chapter. These docs link directly to the Templates chapter, which is a part of their learning pathway.

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

Older Content

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

• https://developer.wordpress.org/themes/advanced-topics/theme-json/

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/global-settings-and-styles/.

Example content for the Notice block:

This article has now been replaced with a dedicated Global Settings and Styles chapter in the Theme Handbook.

[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]

All of these (except the templates docs, which are waiting for the Templates chapter) are now in the Theme Handbook system. I'll go through and publish these once I get the 👍 and do any final link checks.

[justintadlock]

This chapter is now live in the handbook. I'm leaving this ticket open for a bit for folks to report any issues, especially since this is a large chapter with loads of docs.

[justintadlock]

Probably need a section for gotchas, issues, and other theme.json styling issues like this: WordPress/gutenberg#55644