Document theme behavior and format editor styles

style.css

@@ -9,6 +9,7 @@ License: GNU General Public License v2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 */
 
+/* Self-hosted typefaces: keep these paths relative to the theme stylesheet. */
 @font-face {
   font-family: "Alpha Lyrae";
   src: url("fonts/AlphaLyrae-Medium.woff2") format("woff2");
@@ -45,6 +46,7 @@ License URI: https://www.gnu.org/licenses/gpl-2.0.html
   font-display: swap;
 }
 
+/* Shared palette, layout, and code tokens; dark mode overrides the same names below. */
 :root {
   color-scheme: light;
   --bg: #f8f5f0;
@@ -73,6 +75,7 @@ License URI: https://www.gnu.org/licenses/gpl-2.0.html
   --code-text: #f5eee5;
   --shadow: 0 10px 30px rgba(0, 0, 0, 0.25);
 }
+/* Automatic mode (and no saved preference) follows the operating-system color scheme. */
 @media (prefers-color-scheme: dark) {
   :root:not([data-theme]),
   :root[data-theme="auto"] {
@@ -626,6 +629,7 @@ h4 {
     font-size: 1.25rem;
   }
 }
+/* Desktop submenus are positioned from their parent; nested menus fly out to the side. */
 .primary-menu > li {
   position: relative;
 }
@@ -668,6 +672,7 @@ h4 {
 .primary-menu .sub-menu a:focus {
   background: var(--bg);
 }
+/* On small screens, expose the menu hierarchy inline instead of relying on hover. */
 @media (max-width: 760px) {
   .primary-menu .sub-menu {
     position: static;
@@ -758,6 +763,7 @@ h4 {
 .primary-menu > li.menu-item-has-children > a::after {
   vertical-align: -0.2em;
 }
+/* Keep the sticky header below WordPress's admin bar at each core bar height. */
 body.admin-bar .site-header {
   top: 32px;
 }