From a0e22cc3ea37d7a805ef956e48827192e1b2914e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nerijus=20Bend=C5=BEi=C5=ABnas?=
 <nerijus.bendziunas@gmail.com>
Date: Wed, 6 May 2026 05:05:29 +0300
Subject: [PATCH] docs(site): mirror "Why commit-guard?" from README
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Keeps the two landing pages in parity — visitors arriving via GitHub
Pages now get the same value pitch as those reading the README.

Signed-off-by: Nerijus Bendžiūnas <nerijus.bendziunas@gmail.com>
---
 docs/index.html | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/index.html b/docs/index.html
index 0df2c52..bbe0f01 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -305,6 +305,28 @@ <h1>commit-guard</h1>
         </div>
       </section>
 
+      <section id="why">
+        <h2>Why commit-guard? <a href="#why" class="anchor">#</a></h2>
+        <ul>
+          <li>
+            <strong>NLP imperative detection.</strong> Descriptions must start
+            with an imperative verb, verified via nltk POS tagging — not a
+            hand-coded regex of "bad" words.
+          </li>
+          <li>
+            <strong>Signature verification without a local keyring.</strong>
+            Resolves the commit author via the GitHub API and verifies GPG/SSH
+            against their published <code>.gpg</code>/<code>.keys</code> — no
+            per-runner key management.
+          </li>
+          <li>
+            <strong>Strict by default.</strong> Subject format, body, trailers,
+            <code>Signed-off-by</code>, and signature all enforced out of the
+            box; opt out with <code>--disable</code>.
+          </li>
+        </ul>
+      </section>
+
       <section id="install">
         <h2>Install <a href="#install" class="anchor">#</a></h2>
         <div class="install-tabs">