NEVER modify theme files — this includes _sass/minimal-mistakes/, _includes/ (except custom subdirs/files), and _layouts/
Style overrides go in _sass/custom/ following the existing pattern (_*_custom.scss)
Register new custom partials via @import in _sass/minimal-mistakes.scss under the /* Custom */ section
HTML/JS customizations go in _includes/head/custom.html, _includes/footer/custom.html, or new custom includes
Use theme variables ($text-color, $link-color, $muted-text-color, $warning-color, etc.) — no hardcoded colors
Content Coupling Rules
Prefer stable index links over version-specific links unless the page is explicitly about that exact release. Use /play/, /license/, GitHub Releases, /trust/, and /community/ instead of pinning vX.Y.Z URLs in general pages.
Do not duplicate instructions owned by the destination page. Link to the source of truth instead of copying issue-reporting steps, license terms, or contribution process details into every page.
Keep page responsibilities separate: /play/ owns downloads, feedback, and build entry; /license/ owns the stable legal SOT pointer; /trust/ owns release verification, signing identity, project commitments, and public evidence; /community/ owns Discord, contribution entry, and governance; /press/ owns press facts and links.
Jekyll on WSL2
If repo is on a Windows-mounted drive in WSL2, inotify doesn’t work