Repository navigation
Describe the DebateOwl case format on the home page, llms.txt and JSON-LD - #259
Merged
Merged
Conversation
site.json now holds one sentence for what a DebateOwl case contains and one for "no free plan, but the /tools pages are free". The home page FAQ (EN, HU, ES), the SoftwareApplication JSON-LD on / and the guides, and llms.txt quote them. The case generator card, How it works and the hero demo use the new section names (Opening, Argument, Evidence, If they say..., Closing). The rebuttal generator, coach and best-tools guides describe DebateOwl's output in plain words instead of warrants, contentions and frameworks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Stack the demo's form and sample so the case sections get the full width, shorten the sample lines, and move the owl clear of the text. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Warning Review limit reachedEnable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. Next included review available in 59 minutes. View limit details
Note 🎁 Summarized by CodeRabbit Free
Comment |
This was referenced Oct 28, 2026
Programcode
marked this pull request as ready for review
October 28, 2026 18:22
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Task 2 from the 28 Oct site spec, including the free-plan addendum: describe the case format DebateOwl writes everywhere an AI answer reads about the product.
How this relates to
seo/case-format-copy(#252)#252 merged in full. Its branch tip
bb403acband the squash commit on main (a04c1568) differ only inscripts/staging-sync.mjs, a later unrelated change. So this PR branches from main, which already contains #252. It doesn't stack on that branch, and it doesn't repeat any of its edits. #252 covered the guides. This PR covers what it left out:/,/hu,/es): the case generator card, the hero demo, How it works step 2 and two new FAQs;/and on the guides that carry it;/ai-rebuttal-generator,/best-ai-debate-toolsand/ai-debate-coachthat still described DebateOwl's output with warrant, contention and framework. Describe the new case format on the public guides #252 left these alone as pedagogy, but the spec counts them as product description.What changed
src/config/site.jsongainscaseFormat,secondSpeech,freePlanandtagline. The app reads them throughsrc/lib/seo/site-text.tsand i18n default variables ({{caseFormat}},{{freePlan}}).scripts/generate_seo_content.pyreads the same keys. Hungarian and Spanish carry their own translations of the two FAQ answers./and on guides withsoftware: True):descriptionis the tagline plus the format sentence, 298 of 300 characters. The build fails if it goes past 300.featureListgains "Google Docs and PDF export in the case format".npm run backend:statusshowsaiandexport-gdocdeployed after Generate writes cases the way school debaters prepare them #244, and the PDF and Word exports are client-side, so this export already ships.Offer.description. The SoftwareApplicationdescriptionhas no room left under 300 characters.supabase/functions/_shared/prompts/generate.ts, R2 returns no new arguments, about 2 minutes ofreinforceand about 4 minutes of "If they say…" counters./ai-rebuttal-generator,/best-ai-debate-toolsand/ai-debate-coach, descriptions of what DebateOwl outputs or checks now use plain words. Best-tools criterion 1 is now "Structure: does each argument say what is true, why, and why it matters, or is it a wall of text?". LD value and criterion stay, with framework glossed once as "how the judge should decide"./debateowl-pricingmoves to 2026-10-28 because its JSON-LD changed. The other changed guides were already at 2026-10-28 from Describe the new case format on the public guides #252. No other page's date moved.Deviations from the spec, on purpose
/today. It is probably an in-app announcement stored in the database, so I left it alone. How it works step 2, "Get arguments, evidence and counters", was the nearest home-page copy, and it now uses the format./huand/es. The literal English "if they say" doesn't appear there, because those pages use the app's own labels. Counts are in the checklist below. I didn't put English copy into the Hungarian and Spanish pages just to satisfy a grep.Acceptance criteria
caseFormatinsite.json, matching what Generate writes cases the way school debaters prepare them #244 generates./,/huand/es.descriptionincludes the format sentence (298 chars).featureListhas the 8 prep modes plus the export item./ai-rebuttal-generator,/best-ai-debate-tools,/ai-debate-coachand the three vs-pages into sentences. Sentences naming DebateOwl, Case attacker, Ask coach, Sparring or case generator that also contain framework, contention, warrant or impact calculus: 0.grep -ci "if they say":/6,/llms.txt3,/hu0,/es0. On/hu, "Ha azt mondják" appears 5 times; on/es, "Si dicen" 5 times. Deliberate, see above./debateowl-pricing's date moved. The other changed guides were already dated 2026-10-28 by Describe the new case format on the public guides #252.Jargon counts
\b(frameworks?|contentions?|warrants?|impact calculus)\b, visible text / JSON-LD, built HTML.Format pages that keep their own terms, untouched here: /lincoln-douglas-debate 28 / 8, /policy-debate 0 / 0. The remaining single hit on best-tools and coach is the LD "framework" gloss.
Verification
npm run verify, Node 22.23.2,NODE_OPTIONS=--max-old-space-size=3072, local. GitHub Actions is billing-blocked, so this is a local pass, not CI.87c5eddd: exit 0. Unit 96 files / 714 tests, collaboration 30, edge 493 passed / 0 failed, build, prerender, sitemap (52 URLs), check-site and check-links clean, Playwright@smokedesktop Chromium 47 passed.878002a3(hero layout fix): exit 0, same results (unit 714, collaboration 30, edge 493 / 0, sitemap 52, site and link checks clean, smoke 47 passed).python3 scripts/generate_seo_content.pyrun twice gives a byte-identicalpublic/./,/huand/es: 0 errors, 0 warnings.vite preview: all 52 sitemap URLs return 200 with their own title, description and self-canonical (stand-in for the spec'saudit.py). On the served/hu/and/es/HTML, "Ha azt mondják" and "Si dicen" each appear 5 times. I checked the hero at 1024, 1280 and 1440 px. Screenshots in~/.t3/scratch/debateowl-site-1028/shots/on the VPS:home-hero-desktop,home-demo-desktop,home-case-card-*,home-faq-*,hu-faq-*,es-faq-*. The hero demo is hidden below thelgbreakpoint, so it has no mobile shot. The mobile feature cards hide their descriptions by design.Relation to the other two PRs
Independent of #258 (About and Contact) and #260 (plain-language guides). None stacks on another. I trial-merged all three branches together: 0 conflicts. Task 3 doesn't touch the eight product pages this PR edits. If a later merge does conflict in
public/, rerunpython3 scripts/generate_seo_content.py.🤖 Generated with Claude Code