Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/operations.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,9 +60,9 @@ The free tools under `/tools` ([`src/pages/tools/`](../src/pages/tools/)) are pr

[`scripts/check-site.mjs`](../scripts/check-site.mjs) runs next and fails the build when an internal link, a `#fragment`, a sitemap URL or an `llms.txt` URL does not resolve (it applies the `vercel.json` redirects and rewrites), when JSON-LD does not parse or carries HTML entities, when an indexed page other than `/terms`, `/privacy`, and `/expocit/sources` lacks its question H2 (`#short-answer`) as the first H2, when a page's first heading is not its H1 or a heading skips a level (H1 to H3), or when an image has no alt text, a button has no name or a form field has no label.

The guide pages in `public/<slug>/index.html` are generated, not hand-edited: run `python3 scripts/generate_seo_content.py` and commit its output. Short pages live in its `PAGES` list; pages with long-form copy, their own highlight-card descriptions, and their own FAQs (which also feed the page's FAQPage JSON-LD) live in [`scripts/seo_guides.py`](../scripts/seo_guides.py). Keep `PAGES` in order, because each page's related-guide links are picked by position. A guide entry can set its own `modified` date, which overrides `CONTENT_DATE` for that page alone. Pages that show the shared `FAQS` are dated no earlier than `FAQS_DATE`, so move it when those questions change.
The guide pages in `public/<slug>/index.html` are generated, not hand-edited: run `python3 scripts/generate_seo_content.py` and commit its output. Short pages live in its `PAGES` list; pages with long-form copy, their own highlight-card descriptions, and their own FAQs (which also feed the page's FAQPage JSON-LD) live in [`scripts/seo_guides.py`](../scripts/seo_guides.py). Keep `PAGES` in order, because each page's related-guide links are picked by position. A guide entry can set a later `modified` date for that page alone; no page is dated earlier than `CONTENT_DATE`, which covers the copy every guide shares. Sections hold paragraphs and `h3`, `steps`, `list`, `table` and `example` blocks; paragraphs, list items and table cells can hold Markdown-style links to a site path or, for a primary source, an `https://` URL. Pages that show the shared `FAQS` are dated no earlier than `FAQS_DATE`, so move it when those questions change.

Every guide opens with the reader's main question as its first H2 and an answer of at most 100 words, kept in [`scripts/seo_answers.py`](../scripts/seo_answers.py); the generator refuses a page without one or with a longer answer. Each guide shows visible "Published" and "Updated" dates (`PUBLISHED_DATE` or a `published` key, and the `modified` date) that match its Article JSON-LD. Prices and plan facts are stated "as of" the month in `factsCheckedOn` in `src/config/site.json`; move that date when you recheck them, and the generated About line on every guide, `llms.txt` and the landing page follow. Copy in `seo_guides.py` and `seo_answers.py` that names the month itself (prices and competitor facts) needs the same edit: search those files for "As of". The generator also writes `public/llms.txt`, the plain summary for AI agents. `public/robots.txt` allows AI crawlers by name in their own group, which repeats the private-route rules because a crawler that matches a named group ignores `*`.
Every guide opens with the reader's main question as its first H2 and an answer of at most 100 words, kept in [`scripts/seo_answers.py`](../scripts/seo_answers.py); the generator refuses a page without one or with a longer answer. Each guide shows visible "Published" and "Updated" dates (`PUBLISHED_DATE` or a `published` key, and the `modified` date) that match its Article JSON-LD. Prices and plan facts are stated "as of" the month in `factsCheckedOn` in `src/config/site.json`; move that date when you recheck them, and the pricing page's About block, `llms.txt` and the landing page follow. Every other guide has a one-line About that links to the landing page and pricing instead of repeating the plan facts. Copy in `seo_guides.py` and `seo_answers.py` that names the month itself (prices and competitor facts) needs the same edit: search those files for "As of". The generator also writes `public/llms.txt`, the plain summary for AI agents. `public/robots.txt` allows AI crawlers by name in their own group, which repeats the private-route rules because a crawler that matches a named group ignores `*`.

To retire a guide, delete its `PAGES` entry and its `public/<slug>/` folder (the generator never deletes), add its redirects to `vercel.json`, and repoint any link to it. Two guides that answer the same search should become one page, not two thin ones.

Expand Down
16 changes: 8 additions & 8 deletions public/ai-debate-case-generator/index.html

Large diffs are not rendered by default.

16 changes: 8 additions & 8 deletions public/ai-debate-coach/index.html

Large diffs are not rendered by default.

16 changes: 8 additions & 8 deletions public/ai-debate-practice/index.html

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions public/ai-rebuttal-generator/index.html

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions public/ai-vs-traditional-debate-prep/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,12 @@
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="DebateLab debate prep workspace preview" />
<meta property="article:published_time" content="2026-07-05" />
<meta property="article:modified_time" content="2026-10-23" />
<meta property="article:modified_time" content="2026-10-26" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:image" content="https://debate.pi-stack.org/hero-visual.jpg" />
<meta name="twitter:image:alt" content="DebateLab debate prep workspace preview" />
<link rel="stylesheet" href="/seo-pages.css" />
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"Article","headline":"AI vs Traditional Debate Prep","name":"AI vs Traditional Debate Prep | DebateLab","url":"https://debate.pi-stack.org/ai-vs-traditional-debate-prep","description":"Compare AI debate prep tools with traditional research and coaching methods, and learn how to combine both for the strongest tournament preparation.","inLanguage":"en","dateModified":"2026-10-23","datePublished":"2026-07-05","author":{"@type":"Organization","@id":"https://debate.pi-stack.org/#organization","name":"Pi-Stack","url":"https://debate.pi-stack.org/","logo":"https://debate.pi-stack.org/icon-1024.png"},"publisher":{"@type":"Organization","@id":"https://debate.pi-stack.org/#organization","name":"Pi-Stack","url":"https://debate.pi-stack.org/","logo":"https://debate.pi-stack.org/icon-1024.png"},"about":{"@id":"https://debate.pi-stack.org/#software"}},{"@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Is AI debate prep better than traditional research and coaching?","acceptedAnswer":{"@type":"Answer","text":"Neither replaces the other. AI is faster at structure: case outlines, rebuttal blocks, topic brainstorming and evidence leads, which saves time on the repetitive parts of prep. Traditional prep does better at original source reading, real coaching feedback, tournament-specific strategy and adapting to a specific opponent, because those need human judgment. The practical answer is to combine them: use AI for scaffolding, traditional research for depth and coaching for strategy."}},{"@type":"Question","name":"Is DebateLab an AI debate practice platform?","acceptedAnswer":{"@type":"Answer","text":"Yes. DebateLab focuses on debate prep workflows such as cases, rebuttals, evidence, flowcharts, coaching, and timing."}},{"@type":"Question","name":"Should students verify AI-generated debate evidence?","acceptedAnswer":{"@type":"Answer","text":"Yes. AI can suggest research leads, but students should check original sources before using evidence in round."}}]},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"DebateLab by Pi-Stack","item":"https://debate.pi-stack.org/"},{"@type":"ListItem","position":2,"name":"AI vs Traditional Debate Prep","item":"https://debate.pi-stack.org/ai-vs-traditional-debate-prep"}]}]}</script>
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"Article","headline":"AI vs Traditional Debate Prep","name":"AI vs Traditional Debate Prep | DebateLab","url":"https://debate.pi-stack.org/ai-vs-traditional-debate-prep","description":"Compare AI debate prep tools with traditional research and coaching methods, and learn how to combine both for the strongest tournament preparation.","inLanguage":"en","dateModified":"2026-10-26","datePublished":"2026-07-05","author":{"@type":"Organization","@id":"https://debate.pi-stack.org/#organization","name":"Pi-Stack","url":"https://debate.pi-stack.org/","logo":"https://debate.pi-stack.org/icon-1024.png"},"publisher":{"@type":"Organization","@id":"https://debate.pi-stack.org/#organization","name":"Pi-Stack","url":"https://debate.pi-stack.org/","logo":"https://debate.pi-stack.org/icon-1024.png"},"about":{"@id":"https://debate.pi-stack.org/#software"}},{"@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Is AI debate prep better than traditional research and coaching?","acceptedAnswer":{"@type":"Answer","text":"Neither replaces the other. AI is faster at structure: case outlines, rebuttal blocks, topic brainstorming and evidence leads, which saves time on the repetitive parts of prep. Traditional prep does better at original source reading, real coaching feedback, tournament-specific strategy and adapting to a specific opponent, because those need human judgment. The practical answer is to combine them: use AI for scaffolding, traditional research for depth and coaching for strategy."}},{"@type":"Question","name":"Is DebateLab an AI debate practice platform?","acceptedAnswer":{"@type":"Answer","text":"Yes. DebateLab focuses on debate prep workflows such as cases, rebuttals, evidence, flowcharts, coaching, and timing."}},{"@type":"Question","name":"Should students verify AI-generated debate evidence?","acceptedAnswer":{"@type":"Answer","text":"Yes. AI can suggest research leads, but students should check original sources before using evidence in round."}}]},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"DebateLab by Pi-Stack","item":"https://debate.pi-stack.org/"},{"@type":"ListItem","position":2,"name":"AI vs Traditional Debate Prep","item":"https://debate.pi-stack.org/ai-vs-traditional-debate-prep"}]}]}</script>
</head>
<body>
<header class="wrap">
Expand All @@ -31,13 +31,13 @@
<main class="wrap">
<nav class="breadcrumb" aria-label="Breadcrumb"><a href="/">DebateLab</a> / <span aria-current="page">AI vs Traditional Debate Prep</span></nav>
<article>
<header class="hero"><span class="eyebrow">Comparison</span><h1>AI vs Traditional Debate Prep</h1><p class="lead">AI speeds up structure; traditional research and coaching provide depth and judgment.</p><p class="dates">Published <time datetime="2026-07-05">July 5, 2026</time> · Updated <time datetime="2026-10-23">October 23, 2026</time></p><div class="cta"><a class="btn primary" href="/app">Start practicing</a><a class="btn secondary" href="/">See DebateLab</a></div></header>
<header class="hero"><span class="eyebrow">Comparison</span><h1>AI vs Traditional Debate Prep</h1><p class="lead">AI speeds up structure; traditional research and coaching provide depth and judgment.</p><p class="dates">Published <time datetime="2026-07-05">July 5, 2026</time> · Updated <time datetime="2026-10-26">October 26, 2026</time></p><div class="cta"><a class="btn primary" href="/app">Start practicing</a><a class="btn secondary" href="/">See DebateLab</a></div></header>
<section class="answer" aria-labelledby="short-answer"><h2 id="short-answer">Is AI debate prep better than traditional research and coaching?</h2><p>Neither replaces the other. AI is faster at structure: case outlines, rebuttal blocks, topic brainstorming and evidence leads, which saves time on the repetitive parts of prep. Traditional prep does better at original source reading, real coaching feedback, tournament-specific strategy and adapting to a specific opponent, because those need human judgment. The practical answer is to combine them: use AI for scaffolding, traditional research for depth and coaching for strategy.</p></section>
<section class="grid" aria-label="Highlights"><article class="card"><h3>Speed and structure</h3></article><article class="card"><h3>Research depth</h3></article><article class="card"><h3>Human judgment</h3></article></section>
<div class="article section"><h2>What AI does well</h2><p>AI generates structure fast: case outlines, rebuttal blocks, topic brainstorming, and evidence leads. It saves time on the repetitive parts of prep.</p><h2>What traditional prep does better</h2><p>Original source reading, real coaching feedback, tournament-specific strategy, and adapting to a specific opponent all require human judgment.</p><h2>How to combine them</h2><p>Use AI for scaffolding, use traditional research for depth, and use coaching for strategy. DebateLab supports the AI scaffolding step.</p></div>
<section class="section faq article" aria-labelledby="faq"><h2 id="faq">Frequently asked questions</h2><details><summary>Is DebateLab an AI debate practice platform?</summary><p>Yes. DebateLab focuses on debate prep workflows such as cases, rebuttals, evidence, flowcharts, coaching, and timing.</p></details><details><summary>Should students verify AI-generated debate evidence?</summary><p>Yes. AI can suggest research leads, but students should check original sources before using evidence in round.</p></details></section>
</article>
<aside class="section article" aria-labelledby="about"><h2 id="about">About DebateLab</h2><p>DebateLab is an AI debate prep and practice app for students and competitive debaters that builds structured cases, finds the weak points in arguments, researches evidence with citations and runs timed practice rounds against an AI opponent. The app is available in English, Spanish and Hungarian.</p><p>As of October 2026, DebateLab has a 3-day free trial with no credit card required, then Pro costs $5/month + tax. There is no permanent free plan. <a href="/debatelab-pricing">See pricing</a>.</p></aside>
<aside class="section article" aria-labelledby="about"><h2 id="about">About DebateLab</h2><p>DebateLab is an AI debate prep and practice app. See <a href="/">how it works</a> or <a href="/debatelab-pricing">pricing</a>.</p></aside>
<section class="section article" aria-labelledby="related"><h2 id="related">Related DebateLab guides</h2><nav class="links" aria-label="Related guides"><a href="/ai-debate-practice">AI Debate Practice Platform</a>
<a href="/ai-debate-case-generator">AI Debate Case Generator with Citations</a>
<a href="/debate-rebuttal-practice">Debate Rebuttal Practice &amp; Argument Analyzer</a>
Expand Down
Loading
Loading