docs: about page

Author: tiagozip

docs/.vitepress/config.mjs

@@ -1,9 +1,30 @@
+import { execSync } from "node:child_process";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import llmstxt from "vitepress-plugin-llms";
 import { withMermaid } from "vitepress-plugin-mermaid";
-// import { defineConfig } from "vitepress";
 
 const GITHUB_STARS = 6632;
 
+const DOCS_DIR = join(dirname(fileURLToPath(import.meta.url)), "..");
+const gitDatesCache = new Map();
+const gitDates = (relativePath) => {
+  if (gitDatesCache.has(relativePath)) return gitDatesCache.get(relativePath);
+  let dates = null;
+  try {
+    const out = execSync(
+      `git log --follow --format=%aI -- "${relativePath}"`,
+      { cwd: DOCS_DIR, encoding: "utf8" },
+    ).trim();
+    if (out) {
+      const lines = out.split("\n");
+      dates = { published: lines.at(-1), modified: lines[0] };
+    }
+  } catch {}
+  gitDatesCache.set(relativePath, dates);
+  return dates;
+};
+
 const jsonLd = (obj) => [
   "script",
   { type: "application/ld+json" },
@@ -34,10 +55,14 @@ const SOFTWARE_APPLICATION = {
 const ORGANIZATION = {
   "@context": "https://schema.org",
   "@type": "Organization",
+  "@id": "https://trycap.dev/#organization",
   name: "Cap",
   url: "https://trycap.dev",
   logo: "https://trycap.dev/logo.png",
+  foundingDate: "2025-01-11",
+  founder: { "@type": "Person", name: "tiago", url: "https://tiago.zip" },
   sameAs: ["https://github.com/tiagozip/cap", "https://x.com/tiagozip_"],
+  subjectOf: { "@id": "https://trycap.dev/about.html" },
 };
 
 const FAQ_ITEMS = [
@@ -175,8 +200,31 @@ export default withMermaid({
       ["meta", { name: "twitter:title", content: title }],
       ["meta", { name: "twitter:description", content: description }],
     ];
+    const dates = gitDates(pageData.relativePath);
+    const published = pageData.frontmatter.datePublished || dates?.published;
+    const modified = dates?.modified;
+    if (published) {
+      head.push(["meta", { property: "article:published_time", content: published }]);
+    }
+    if (modified) {
+      head.push(["meta", { property: "article:modified_time", content: modified }]);
+    }
     if (pageData.relativePath === "index.md") {
       head.push(jsonLd(SOFTWARE_APPLICATION), jsonLd(ORGANIZATION), jsonLd(FAQ_PAGE));
+    } else if (pageData.relativePath === "about.md") {
+      head.push(
+        jsonLd(ORGANIZATION),
+        jsonLd({
+          "@context": "https://schema.org",
+          "@type": "AboutPage",
+          "@id": "https://trycap.dev/about.html",
+          name: "About Cap",
+          url: "https://trycap.dev/about.html",
+          description,
+          mainEntity: { "@id": "https://trycap.dev/#organization" },
+          ...(modified && { dateModified: modified }),
+        }),
+      );
     } else {
       const bc = breadcrumbList(pageData);
       if (bc) head.push(jsonLd(bc));
@@ -191,6 +239,9 @@ export default withMermaid({
             url: canonical,
             about: { "@id": "https://trycap.dev/#software" },
             author: { "@type": "Person", name: "tiago", url: "https://tiago.zip" },
+            publisher: { "@id": "https://trycap.dev/#organization" },
+            ...(published && { datePublished: published }),
+            ...(modified && { dateModified: modified }),
           }),
           jsonLd({
             "@context": "https://schema.org",

docs/about.md

@@ -0,0 +1,33 @@
+---
+title: About Cap
+description: "Who builds Cap, the open-source, self-hosted CAPTCHA alternative: its maintainer, history, license, funding, and how to get in touch."
+sidebar: false
+---
+
+# About Cap
+
+**TL;DR:** Cap is a free, open-source CAPTCHA alternative that replaces visual puzzles with proof-of-work and instrumentation challenges. It's licensed under Apache 2.0 and runs entirely on your own infrastructure, so visitor data never reaches a third party.
+
+## What is Cap?
+
+Cap is bot protection you can read, audit, and self-host:
+
+- A **~20 KB widget** that renders a single checkbox instead of image puzzles.
+- A **standalone server** that ships as one Docker container with a dashboard and multi-site-key support.
+- **Server libraries** (`@cap.js/server` and community ports) for verifying challenges in your own backend.
+- A **siteverify API compatible with reCAPTCHA and hCaptcha**, so migrating is mostly a URL swap.
+
+The full source lives at [github.com/tiagozip/cap](https://github.com/tiagozip/cap) under the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0).
+
+## Why does Cap exist?
+
+Mainstream CAPTCHAs either interrogate users with puzzles or profile them with fingerprinting and risk scores, and both approaches route your visitors' data through a vendor. Cap takes a different position:
+
+- **Deterministic, not judgmental.** Every real user has a guaranteed path through; no classifier can silently reject someone for using a VPN or a privacy browser.
+- **Self-hosted, not rented.** Verification happens on your servers, which makes GDPR and CCPA answers simple. See [Compliance](./guide/compliance.md).
+- **Open, not promised.** Privacy claims are auditable because the code that makes decisions is public.
+
+## Get in touch
+
+- Bugs and feature requests: [GitHub issues](https://github.com/tiagozip/cap/issues)
+- Security reports and everything else: [hi@tiago.zip](mailto:hi@tiago.zip)