docs: add alignment references to CSS rules

Document which CSS reset authors/projects align with each rule:
- Josh Comeau, Andy Bell (Piccalilli), Tailwind Preflight
- Normalize.css, Modern Normalize (Sindre Sorhus)
- Eric Meyer Reset, Elad Shechter (The New CSS Reset)
- Keith J. Grant, Jake Lazaroff, Kilian Valkhof
- CSS-Tricks, GitHub, Bootstrap 5

Author: swernerx

src/elements.css

@@ -14,6 +14,13 @@
    *
    * --font-system-ui-sans: Modern system UI font stack with full emoji support.
    * --font-system-ui-mono: Modern monospace font stack for code elements.
+   *
+   * Aligned with:
+   * - CSS-Tricks (Chris Coyier) – System Font Stack article
+   * - Tailwind Preflight – system-ui based font stack
+   * - GitHub – uses similar system font stack
+   * - Bootstrap 5 – native font stack
+   * - Andy Bell (Piccalilli) – system-ui, sans-serif
    */
   :root {
     --font-system-ui-sans:
@@ -32,6 +39,11 @@
    * - line-height: 1.5 improves readability for body text
    * - min-height: 100dvh prevents "short body" issues, enables sticky footers
    * - overflow-wrap: break-word prevents horizontal overflow from long words/URLs
+   *
+   * Aligned with:
+   * - line-height: Josh Comeau (1.5), Andy Bell (1.5), Tailwind (1.5)
+   * - min-height: Josh Comeau (100%), Andy Bell (100%), Modern best practice (100dvh)
+   * - overflow-wrap: Josh Comeau (break-word on specific elements)
    */
   body {
     font-family: var(--font-system-ui-sans);
@@ -42,6 +54,10 @@
 
   /**
    * ELT-023: Apply monospace font stack to code elements.
+   *
+   * Aligned with:
+   * - Tailwind Preflight – code, kbd, samp, pre { font-family: monospace stack }
+   * - Normalize.css – code, kbd, samp { font-family: monospace }
    */
   code,
   pre,
@@ -54,6 +70,10 @@
    * ELT-010: Minor link improvements while keeping them recognizable.
    * text-decoration-skip-ink improves readability of underlines
    * by avoiding crossing descenders (g, j, p, q, y).
+   *
+   * Aligned with:
+   * - Andy Bell (Piccalilli) – a { text-decoration-skip-ink: auto }
+   * - Modern browser default (but explicit is better)
    */
   a {
     text-decoration-skip-ink: auto;
@@ -69,5 +89,9 @@
    *
    * ELT-030, ELT-031: No fluid typography, scales, or clamp()-based
    * font sizing in v1. Only default UA behavior + base font family.
+   *
+   * Intentionally NOT included (contrary to some resets):
+   * - Elad Shechter removes list-style completely
+   * - Some resets add heading margins back
    */
 }

src/fixes.css

@@ -19,16 +19,28 @@
    * - https://developer.mozilla.org/en-US/docs/Web/CSS/text-size-adjust
    * - https://kilianvalkhof.com/2022/css-html/your-css-reset-needs-text-size-adjust-probably/
    * - https://webkit.org/blog/57/css3-text-size-adjust/
+   *
+   * Aligned with:
+   * - Normalize.css – html { -webkit-text-size-adjust: 100% }
+   * - Modern Normalize (Sindre Sorhus) – text-size-adjust: 100%
+   * - Kilian Valkhof (CSS-Tricks article) – explicit recommendation
    */
   html {
     -webkit-text-size-adjust: 100%;
     text-size-adjust: 100%;
+
     /**
      * Normalize tab character width in <pre> elements.
      * Browsers default to 8 spaces which is excessively wide.
      *
      * References:
      * - https://developer.mozilla.org/en-US/docs/Web/CSS/tab-size
+     *
+     * Aligned with:
+     * - Normalize.css – html { tab-size: 4 }
+     * - Modern Normalize (Sindre Sorhus) – tab-size: 4
+     * - Tailwind Preflight – tab-size: 4
+     * (We use 2 for more compact code display)
      */
     -moz-tab-size: 2;
     tab-size: 2;
@@ -47,6 +59,11 @@
    * - https://www.smashingmagazine.com/2021/10/respecting-users-motion-preferences/
    * - https://web.dev/prefers-reduced-motion/
    *
+   * Aligned with:
+   * - Josh Comeau – @media (prefers-reduced-motion: reduce) handling
+   * - Andy Bell (Piccalilli) – more aggressive (animation/transition-duration: 0.01ms)
+   * - Jake Lazaroff – scroll-behavior: auto
+   *
    * UFX-022: Additional reductions (animation-duration, transition-duration)
    * are intentionally omitted in v1 to avoid breaking intentional animations.
    * Implementers should handle these in their own stylesheets as needed.

src/reset.css

@@ -14,6 +14,13 @@
    *
    * Note: We use a direct approach rather than inheritance (RST-021, RST-023)
    * to ensure compatibility with Web Components and slotted content (WC-003).
+   *
+   * Aligned with:
+   * - Andy Bell (Piccalilli) – margin: 0 on *, box-sizing: border-box
+   * - Tailwind Preflight – margin: 0, box-sizing: border-box
+   * - Elad Shechter (The New CSS Reset) – via all: unset approach
+   * - Eric Meyer Reset – margin: 0, padding: 0
+   * - Josh Comeau – box-sizing: border-box (margin only on body)
    */
   *,
   *::before,
@@ -32,6 +39,12 @@
    * RST-031: Media elements get block display with responsive sizing.
    * This prevents unwanted whitespace below inline images and ensures
    * media elements don't overflow their containers.
+   *
+   * Aligned with:
+   * - Josh Comeau – img, picture, video, canvas, svg { display: block; max-width: 100% }
+   * - Andy Bell (Piccalilli) – img, picture { display: block; max-width: 100% }
+   * - Tailwind Preflight – img, video { display: block; max-width: 100% }
+   * - Keith J. Grant – img { max-width: 100% }
    */
   img,
   picture,
@@ -46,6 +59,12 @@
   /**
    * RST-040: Form elements inherit font from their parent.
    * This ensures consistent typography across form controls.
+   *
+   * Aligned with:
+   * - Josh Comeau – input, button, textarea, select { font: inherit }
+   * - Andy Bell (Piccalilli) – input, button, textarea, select { font: inherit }
+   * - Tailwind Preflight – button, input, select, textarea { font-family/size/line-height: inherit }
+   * - Normalize.css – partial (font-family: inherit on button/input)
    */
   button,
   input,
@@ -58,11 +77,21 @@
    * RST-041: Focus indicators are NOT removed (no global outline: none).
    * RST-042: cursor: pointer is NOT set globally.
    * These are intentionally omitted to preserve accessibility defaults.
+   *
+   * Aligned with:
+   * - Josh Comeau – explicitly does NOT remove outlines
+   * - Andy Bell (Piccalilli) – explicitly does NOT remove outlines
+   * - WCAG accessibility guidelines
    */
 
   /**
    * Normalize table border behavior.
    * UA defaults for border-collapse vary; this ensures consistent table rendering.
+   *
+   * Aligned with:
+   * - Andy Bell (Piccalilli) – table { border-collapse: collapse }
+   * - Tailwind Preflight – table { border-collapse: collapse }
+   * - Eric Meyer Reset – table { border-collapse: collapse; border-spacing: 0 }
    */
   table {
     border-collapse: collapse;