docs: match the home page to what the tools do, and unify site colors

The review and summary comment mockups now show github-actions as the
author, with the wording cpp-linter actually posts. There is no
cpp-linter bot account; comments come from the workflow token or your
own App.

Copy that read opt-in features as defaults now names the input and the
permission it needs: review suggestions, the summary comment and
auto-fix. The version pin, the CLI in other CI, the clang-tools
channels (Docker up to 22, a macOS Homebrew tap for 19 to 23) and the
licensing are stated as they are. The quick start uses checkout@v7 and
one review type, and no longer sets thread-comments, which fails on
pull requests from forks.

Waybar only keeps the action in a disabled .yml.bak workflow, so it is
dropped from the home page and the showcase, and the star total falls
to 75,000+. The other 34 showcase projects were rechecked.

Inner pages now use the home page's paper background, light header and
tabs, ink footer and fonts in the light scheme. Fonts load site-wide
from overrides/main.html; the dark scheme keeps Material's colors.

Author: shenxianpeng

docs/index.md

@@ -5,7 +5,7 @@ hide:
   - feedback
 template: home.html
 title: C/C++ Linting
-description: clang-format and clang-tidy for C and C++ pull requests, pre-commit hooks and CI, with one LLVM version everywhere.
+description: clang-format and clang-tidy for C and C++ pull requests, pre-commit hooks and CI, with the LLVM version you pin.
 ---
 
 <!-- The home page is built by docs/overrides/home.html. -->

docs/overrides/home.html

@@ -0,0 +1,15 @@
+{% extends "base.html" %}
+
+{#-
+  The site's fonts, loaded on every page: Instrument Sans for text,
+  JetBrains Mono for code and Bricolage Grotesque for headings. theme.font is
+  false in mkdocs.yml, so Material loads nothing itself; extra.css points
+  Material's font variables at these.
+-#}
+
+{% block extrahead %}
+  {{ super() }}
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,500..800&family=Instrument+Sans:ital,wght@0,400..700;1,400..700&family=JetBrains+Mono:ital,wght@0,400..700;1,400..700&display=swap">
+{% endblock %}

docs/overrides/main.html

@@ -8,20 +8,22 @@ description: Open-source projects that run cpp-linter-action and cpp-linter-hook
 <!-- markdownlint-disable MD033 -->
 
 More than 550 public repositories run [cpp-linter-action](https://github.com/cpp-linter/cpp-linter-action)
-from a workflow on their default branch, with over 87,000 GitHub stars between them.
-The list below is the top of that set, ranked by stars.
+from a workflow on their default branch, with over 75,000 GitHub stars between them.
+The list below is a selection from that set, ranked by stars.
 
 !!! info "How this list is built"
     Numbers come from a GitHub code search for `cpp-linter/cpp-linter-action@` inside
     `.github/workflows`, restricted to non-fork, non-archived repositories, on 2026-09-12.
     Forks and mirrors are excluded, so the real number is higher. Star counts are from the same day.
+    On 2026-09-24 the totals were recounted with only `.yml` and `.yaml` workflow files, so a
+    disabled file such as `.yml.bak` does not count, and every project below was rechecked the
+    same way.
 
 ## Projects
 
 | Project | Stars | What it is |
 | --- | ---: | --- |
 | <img src="https://github.com/zealdocs.png?size=40" width="20" alt=""> [zealdocs/zeal](https://github.com/zealdocs/zeal) | 12,789 | Offline documentation browser |
-| <img src="https://github.com/Alexays.png?size=40" width="20" alt=""> [Alexays/Waybar](https://github.com/Alexays/Waybar) | 11,944 | Highly customizable Wayland bar for Sway and wlroots compositors |
 | <img src="https://github.com/libvips.png?size=40" width="20" alt=""> [libvips/libvips](https://github.com/libvips/libvips) | 11,633 | Fast image processing library with low memory needs |
 | <img src="https://github.com/diasurgical.png?size=40" width="20" alt=""> [diasurgical/DevilutionX](https://github.com/diasurgical/DevilutionX) | 9,736 | Diablo build for modern operating systems |
 | <img src="https://github.com/iree-org.png?size=40" width="20" alt=""> [iree-org/iree](https://github.com/iree-org/iree) | 3,925 | Retargetable MLIR-based machine learning compiler and runtime |

docs/showcase.md

@@ -70,16 +70,93 @@
     box-shadow: 0 4px 12px rgba(0,0,0,0.15);
 }
 
-/* Ensure tab items have proper contrast */
-.md-tabs__item {
-    background-color: transparent;
+/* Fonts: loaded in overrides/main.html (theme.font is false) */
+:root {
+    --md-text-font: "Instrument Sans";
+    --md-code-font: "JetBrains Mono";
 }
 
-.md-tabs__link {
-    color: rgba(255, 255, 255, 0.7);
+.md-typeset h1,
+.md-typeset h2,
+.md-typeset h3,
+.md-header__topic:first-child {
+    font-family: "Bricolage Grotesque", var(--md-text-font-family);
+    letter-spacing: -0.01em;
 }
 
-.md-tabs__link--active,
-.md-tabs__link:hover {
-    color: white;
+.md-typeset h1 {
+    color: var(--md-default-fg-color);
+    font-weight: 760;
+}
+
+.md-typeset h2,
+.md-typeset h3 {
+    font-weight: 700;
+}
+
+/*
+ * Light scheme: the paper, ink and light header of the home page.
+ * The dark scheme keeps Material's colors.
+ */
+[data-md-color-scheme="default"] {
+    --md-default-fg-color: #171a2ede;
+    --md-default-fg-color--light: #171a2e8f;
+    --md-default-fg-color--lighter: #171a2e52;
+    --md-default-fg-color--lightest: #171a2e12;
+    --md-default-bg-color: #f7f5ef;
+    --md-code-bg-color: #eeeae0;
+    --md-code-bg-color--light: #eeeae0b3;
+    --md-code-bg-color--lighter: #eeeae04d;
+    --md-footer-bg-color: #171a2e;
+    --md-footer-bg-color--dark: #10131f;
+}
+
+[data-md-color-scheme="default"] .md-header,
+[data-md-color-scheme="default"] .md-tabs {
+    background-color: #f7f5ef;
+    color: #171a2e;
+}
+
+[data-md-color-scheme="default"] .md-header {
+    border-bottom: 1px solid #e3dfd3;
+}
+
+[data-md-color-scheme="default"] .md-tabs__link {
+    color: #454a63;
+    opacity: 1;
+}
+
+[data-md-color-scheme="default"] .md-tabs__item--active .md-tabs__link,
+[data-md-color-scheme="default"] .md-tabs__link:hover {
+    color: #171a2e;
+}
+
+[data-md-color-scheme="default"] .md-tabs__item--active .md-tabs__link {
+    font-weight: 700;
+}
+
+[data-md-color-scheme="default"] .md-nav--primary .md-nav__title[for="__drawer"] {
+    background-color: #f7f5ef;
+    color: #171a2e;
+}
+
+[data-md-color-scheme="default"] .md-nav__source {
+    background-color: #171a2e;
+}
+
+@media screen and (min-width: 60em) {
+    [data-md-color-scheme="default"] .md-search__form,
+    [data-md-color-scheme="default"] .md-search__form:hover {
+        background-color: #fff;
+        border: 1px solid #d8d3c4;
+        border-radius: 0.4rem;
+    }
+
+    [data-md-color-scheme="default"] .md-search__input::placeholder {
+        color: #62677f;
+    }
+
+    [data-md-color-scheme="default"] .md-search__input + .md-search__icon {
+        color: #454a63;
+    }
 }

docs/stylesheets/extra.css

@@ -784,15 +784,25 @@
     font-size: 14px;
 }
 
-.cl-comment__head img,
-.cl-summary__head img {
+/* comments come from the github-actions bot (or your App), shown with a neutral avatar */
+.cl-avatar {
+    display: inline-flex;
+    flex-shrink: 0;
+    align-items: center;
+    justify-content: center;
     box-sizing: border-box;
     width: 26px;
     height: 26px;
-    padding: 2px;
-    background: #fff;
+    background: #eeebe3;
     border: 1px solid var(--cl-line);
     border-radius: 999px;
+    color: var(--cl-ink-2);
+}
+
+.cl-avatar svg {
+    width: 14px;
+    height: 14px;
+    fill: currentcolor;
 }
 
 .cl-comment__bot {
@@ -806,15 +816,8 @@
     text-transform: uppercase;
 }
 
-.cl-comment__tool {
-    margin-left: auto;
-    padding: 3px 8px;
-    background: var(--cl-primary-tint);
-    border-radius: 6px;
+.cl-comment__check {
     color: var(--cl-primary);
-    font-family: var(--cl-mono);
-    font-size: 11.5px;
-    font-weight: 600;
 }
 
 .cl-comment__body {
@@ -1007,6 +1010,7 @@
 .cl-tool__code {
     display: flex;
     align-items: center;
+    white-space: pre-line;
     box-sizing: border-box;
     min-height: 62px;
     margin-top: auto;
@@ -1220,11 +1224,15 @@
     font-size: 13.5px;
 }
 
-.cl-summary__head img {
+.cl-summary__head .cl-avatar {
     width: 22px;
     height: 22px;
 }
 
+.cl-summary__report strong {
+    margin-right: 4px;
+}
+
 .cl-tag {
     padding: 4px 11px;
     border-radius: 999px;

docs/stylesheets/home.css

@@ -31,6 +31,8 @@ theme:
     - search.suggest
     - search.share
     - toc.follow
+  # Fonts load in docs/overrides/main.html.
+  font: false
   logo: static/logo.png
   favicon: static/favicon.ico
   icon: