From 6e0d16d1bb7e0dc65b06d19fd2f25d2938389511 Mon Sep 17 00:00:00 2001
From: Timothy DeHerrera <tim@nrdxp.dev>
Date: Wed, 4 Feb 2026 11:15:45 -0700
Subject: [PATCH] docs: clarify JS-free comparison claims
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Rename "Zero JS Output" to "JS-Free Rich Content" with footnote
explaining that all generators can produce JS-free basic HTML—sukr's
distinction is built-in build-time math and diagram rendering.
---
 docs/content/comparison.md | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/docs/content/comparison.md b/docs/content/comparison.md
index a3265cc..38036f8 100644
--- a/docs/content/comparison.md
+++ b/docs/content/comparison.md
@@ -8,15 +8,17 @@ This page provides a factual comparison of sukr with other popular static site g
 
 ## Feature Matrix
 
-| Feature                 |      sukr       |  Zola   |     Hugo     |    Eleventy     |
-| :---------------------- | :-------------: | :-----: | :----------: | :-------------: |
-| **Language**            |      Rust       |  Rust   |      Go      |     Node.js     |
-| **Single Binary**       |       ✅        |   ✅    |      ✅      |       ❌        |
-| **Syntax Highlighting** |   Tree-sitter   | syntect |    Chroma    |  Plugin-based   |
-| **Build-time Math**     | ✅ KaTeX→MathML |   ❌    |      ❌      | Plugin required |
-| **Build-time Diagrams** | ✅ Mermaid→SVG  |   ❌    |      ❌      | Plugin required |
-| **Zero JS Output**      |       ✅        |   ❌    |      ❌      |  Configurable   |
-| **Template Engine**     |      Tera       |  Tera   | Go templates |    Multiple     |
+| Feature                   |      sukr       |  Zola   |     Hugo     |    Eleventy     |
+| :------------------------ | :-------------: | :-----: | :----------: | :-------------: |
+| **Language**              |      Rust       |  Rust   |      Go      |     Node.js     |
+| **Single Binary**         |       ✅        |   ✅    |      ✅      |       ❌        |
+| **Syntax Highlighting**   |   Tree-sitter   | syntect |    Chroma    |  Plugin-based   |
+| **Build-time Math**       | ✅ KaTeX→MathML |   ❌    |      ❌      | Plugin required |
+| **Build-time Diagrams**   | ✅ Mermaid→SVG  |   ❌    |      ❌      | Plugin required |
+| **JS-Free Rich Content**¹ |       ✅        |   ❌    |      ❌      |  Configurable   |
+| **Template Engine**       |      Tera       |  Tera   | Go templates |    Multiple     |
+
+¹ _All generators can produce JS-free HTML for basic content. This row refers to built-in math and diagram rendering without client-side JavaScript. Zola and Hugo require external JS libraries (MathJax, Mermaid.js) for these features._
 
 ## Syntax Highlighting