// The documentation manifest — the one reviewable list that decides what /docs
// contains, in what order, under which headings.
//
// WHY A MANIFEST AND NOT FRONTMATTER. Nothing in this tree parses frontmatter,
// and adding `gray-matter` would fight the workspace's `minimumReleaseAge` pin
// for a dependency whose whole job is to hold four strings. Beyond that: order
// and grouping are EDITORIAL decisions about the set, not facts about any one
// file — a page can't sensibly declare that it comes third. Here a typo is a
// `tsc` error rather than a page that quietly vanishes from the index.

export type DocGroup = "start" | "operate" | "publish" | "extend";

export type DocEntry = {
  /** URL segment: /docs/<slug>/ */
  slug: string;
  /** File under content/docs/. */
  file: string;
  /** <h1> and nav label. */
  title: string;
  /** One line, shown on the index and as the page's meta description. */
  blurb: string;
  group: DocGroup;
};

export const DOC_GROUP_ORDER: { id: DocGroup; label: string }[] = [
  { id: "start", label: "Start here" },
  { id: "operate", label: "Running it" },
  { id: "publish", label: "Publishing" },
  { id: "extend", label: "Going further" },
];

export const DOCS: DocEntry[] = [
  {
    slug: "what-is-archilyzer",
    file: "what-is-archilyzer.md",
    title: "What Archilyzer is",
    blurb:
      "The shape of the thing: three programs, one corpus, and a static site at the end of it.",
    group: "start",
  },
  {
    slug: "install",
    file: "install.md",
    title: "Install",
    blurb:
      "What to install, in what order, and which parts you can skip until you need them.",
    group: "start",
  },
  {
    slug: "operate",
    file: "operate.md",
    title: "Running an archive",
    blurb:
      "Adding channels, downloading, transcribing, and keeping an archive current without babysitting it.",
    group: "operate",
  },
  {
    slug: "deploy-cloudflare",
    file: "deploy-cloudflare.md",
    title: "Deploy to Cloudflare",
    blurb:
      "Publishing the static site to Pages, and what to do about archives too large for it.",
    group: "publish",
  },
  {
    slug: "deploy-docker",
    file: "deploy-docker.md",
    title: "Building several sites at once",
    blurb:
      "Build all sites: parallel per-site builds in isolated containers, whenever a container engine is available.",
    group: "publish",
  },
  {
    slug: "ai-and-mcp",
    file: "ai-and-mcp.md",
    title: "AI and MCP",
    blurb:
      "Every archive is machine-navigable. Point Claude Code, Cursor, or a browser chat at it.",
    group: "extend",
  },
  {
    slug: "faq",
    file: "faq.md",
    title: "Questions",
    blurb:
      "Cost, legality, hardware, what happens when a video disappears, and what this is not.",
    group: "extend",
  },
];