Exercise 1: A Theme Missing Its style.css Comment Header — Possible Solution ==================================================================== WHAT ACTUALLY HAPPENS ------------------------------ The theme will not appear anywhere in the WordPress dashboard - it won't show up under Appearance -> Themes at all, regardless of how complete or correctly styled the rest of style.css and index.php actually are. WHY THIS HAPPENS, PER THIS CHAPTER ------------------------------ Per this chapter's own warn-box, "without this exact header, WordPress won't recognize the folder as a theme at all - it simply won't appear in Appearance -> Themes, no matter how much other CSS the file contains below it." WordPress specifically scans every theme folder's style.css file looking for that special comment block (Theme Name, Author, Version, and so on) as the mechanism it uses to detect and register themes in the first place. Having valid, working CSS rules and a working index.php has nothing to do with this detection step - the comment header is a completely separate requirement from whether the CSS or PHP code itself is functionally correct. WHY THIS IS EASY TO MISS AS A MISTAKE ------------------------------ Because style.css still technically works as an ordinary CSS file (any actual style rules in it would still be syntactically valid CSS), and index.php would still be valid PHP, a developer could reasonably assume everything necessary is in place. The comment header requirement is a WordPress-specific parsing convention layered on top of an otherwise ordinary CSS file, not something a general web developer would necessarily expect just from CSS/PHP knowledge alone. WHAT THE DEVELOPER WOULD NEED TO DO TO FIX IT ------------------------------ Add the correctly-formatted comment block (per this chapter's own example: Theme Name, Theme URI, Author, Description, Version, License, Text Domain) at the very top of style.css. Once that header is present and correctly formatted, the theme would then appear normally in the dashboard's theme browser. WHY THIS WORKS AS AN ANSWER ------------------------------ It states the precise, concrete outcome (invisible in the dashboard, not a partial or degraded theme), cites this chapter's own explicit statement of why, and explains why this specific failure mode is easy to overlook since the rest of the theme's code remains technically valid despite the missing header.