Skip to content

fix(landing): public roadmap and FAQ only claim what ships - #394

Merged
thierryvm merged 1 commit into
mainfrom
fix/landing-roadmap-accuracy
Sep 26, 2026
Merged

thierryvm merged 1 commit into
mainfrom
fix/landing-roadmap-accuracy

Conversation

@thierryvm

@thierryvm thierryvm commented Sep 26, 2026 •

Copy link
Copy Markdown
Owner

Summary

@Thierry asked to check the public roadmap on the landing page. Every line was compared with the code; several public claims promised more than what ships.

  • LTI 1.3 was listed as available. api/lti/launch.ts is a spike gated by LTI_ENABLED (503 in production). Moved to "Plus tard".
  • OpenAI was listed as a working BYOK provider. OpenAI's API refuses browser calls (CORS); AiKeySetup.tsx already warns the learner. Roadmap, llms.txt and llms-full.txt now point to OpenRouter for OpenAI models. The consent modal and privacy policy still name OpenAI on purpose: a learner can store an OpenAI key, so data may go there.
  • "WCAG 2.2 AAA" overstated accessibility; only target size aims at AAA. Replaced by the implemented criteria.
  • "En cours" listed frozen or already shipped work (Sprint 2.C, admin widgets). It now lists the actual check-up work.
  • index.html FAQ (JSON-LD, indexed by search and AI engines): LTI no longer "en cours de finalisation", the teacher space is described as shipped (it was "prévu pour juin 2026"), and the database region is Ireland (eu-west-1, confirmed through the Management API), not Frankfurt.
  • New SEO test: the FAQ's RGPD answer must name the same region and country as PrivacyPolicy.tsx. It fails on the previous index.html.
  • Counters: 2 700+ tests, 21 audit agents. docs/ROADMAP.md and docs/plan.md banners brought to 26 September.

Test plan

  • tsc --noEmit, eslint src, vite build
  • vitest run: 2724 passed; the only failures are live-Supabase integration tests (supportTickets, supportScreenshotUrlConstraint, approveTeacher) that fail intermittently under full-suite concurrency and pass 32/32 when rerun on their own. Unrelated to this diff; tracked separately.
  • New SEO test proven to fail on the old index.html (stash) and pass on the new one
  • Every JSON-LD block in index.html still parses
  • Local Chrome: roadmap renders; no horizontal overflow at 1280 px and at 390 px (device emulation)
  • feature-dev:code-reviewer: its one finding (the index.html FAQ) is fixed in this PR
  • Production census before this PR: 198/198 exercises without a red line, desktop and mobile 390 px
  • CI, Sourcery, preview check

🤖 Generated with Claude Code

Résumé par Sourcery

Veiller à ce que les affirmations publiques concernant le produit et le SEO correspondent aux fonctionnalités actuellement disponibles.

Corrections de bugs :

  • Corriger la feuille de route publique, le contenu destiné aux LLM et les données FAQ structurées afin qu’ils décrivent précisément les fonctionnalités disponibles et reportent les intégrations indisponibles.
  • Harmoniser la région et le pays Supabase de la FAQ avec la politique de confidentialité.

Améliorations :

  • Actualiser les affirmations de la feuille de route de la page d’accueil concernant les fournisseurs d’IA, l’accessibilité, les métriques de qualité et les travaux actuels de vérification.
  • Mettre à jour les bannières d’état de la feuille de route et du plan de lancement avec les dernières avancées en matière de fidélité du terminal et la couverture vérifiée des exercices.

Documentation :

  • Mettre à jour le journal des modifications et la documentation publique de la feuille de route afin de refléter les capacités vérifiées du produit et les travaux prévus.

Tests :

  • Ajouter un test de régression SEO pour vérifier que la région de la base de données de la FAQ correspond à celle indiquée dans la politique de confidentialité.
Original summary in English

Summary by Sourcery

Ensure public product and SEO claims match the functionality currently shipped.

Bug Fixes:

  • Correct public roadmap, LLM-facing content, and structured FAQ data so they accurately describe shipped functionality and defer unavailable integrations.
  • Align the FAQ’s Supabase region and country with the privacy policy.

Enhancements:

  • Refresh landing-page roadmap claims for AI providers, accessibility, quality metrics, and current check-up work.
  • Update roadmap and launch-plan status banners with the latest terminal-fidelity progress and verified exercise coverage.

Documentation:

  • Update the changelog and public roadmap documentation to reflect verified product capabilities and planned work.

Tests:

  • Add an SEO regression test ensuring the FAQ’s database region matches the privacy policy.

- LTI 1.3 moves from "available" to "later": api/lti/launch.ts is a spike
  gated by LTI_ENABLED (503 in production).
- OpenAI is no longer listed as a working BYOK provider: its API refuses
  browser calls (CORS), as the key setup screen already says. Roadmap,
  llms.txt and llms-full.txt point to OpenRouter for OpenAI models.
- "WCAG 2.2 AAA" replaced by what is actually implemented.
- "In progress" shows the real work (terminal fidelity, theory checks,
  reference page) instead of frozen or already shipped items.
- index.html FAQ (JSON-LD): LTI no longer "being finalised", the teacher
  space is described as shipped, and the database region is Ireland
  (eu-west-1), not Frankfurt. A new SEO test ties the FAQ region to the
  privacy policy.
- Counters: 2 700+ tests, 21 audit agents. ROADMAP.md and plan.md banners
  brought to 26 September.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@vercel

vercel Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
terminal-learning Ready Ready Preview Sep 26, 2026 2:54pm UTC

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry @thierryvm, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 14 minutes by commenting @sourcery-ai review. Upgrade to get a review now.

@sourcery-ai

sourcery-ai Bot commented Sep 26, 2026

Copy link
Copy Markdown

Guide du réviseur

La PR vérifie et révise les affirmations des pages d’accueil, destinées aux LLM, de la documentation et de la FAQ afin qu’elles décrivent précisément les fonctionnalités livrées, tout en ajoutant un test de régression SEO pour empêcher toute dérive de la région de confidentialité.

Diagramme de flux pour valider les affirmations publiques sur le produit

flowchart LR
    Code[Shipped functionality and configuration] --> Audit[Compare public claims with implementation]
    Audit --> Landing[Landing roadmap and trust badges]
    Audit --> LLM[llms.txt and llms-full.txt]
    Audit --> Docs[Roadmap and launch plan]
    Audit --> FAQ[index.html FAQ JSON-LD]
    FAQ --> SEO[SEO regression test]
    Privacy[PrivacyPolicy.tsx] --> SEO
    SEO --> Match[Region and country remain consistent]
Loading

Modifications au niveau des fichiers

Modification Détails Fichiers
Corriger les affirmations publiques concernant la roadmap afin de refléter les fonctionnalités implémentées et les travaux en cours.
  • Déplacé LTI 1.3 désactivé et l’option BYOK directe d’OpenAI, incompatible avec les navigateurs, hors des fonctionnalités disponibles.
  • Remplacé l’affirmation exagérée concernant la conformité WCAG AAA et les anciennes entrées de la roadmap par les travaux implémentés sur l’accessibilité, la fidélité de l’interface, le programme pédagogique et la plateforme.
  • Mis à jour les compteurs publics, les badges de confiance et les horodatages de la documentation de la roadmap.
src/app/data/landingContent.ts
public/llms.txt
public/llms-full.txt
docs/ROADMAP.md
docs/plan.md
CHANGELOG.md
Aligner les données structurées de la FAQ indexée sur les fonctionnalités livrées du produit et les informations de confidentialité vérifiées.
  • Décrit l’espace enseignant comme disponible et LTI comme planifié plutôt que presque terminé.
  • Corrigé la région Supabase de Francfort vers eu-west-1 en Irlande.
  • Ajouté un test de régression exigeant que la réponse RGPD de la FAQ corresponde à la région et au pays indiqués dans la politique de confidentialité.
index.html
src/test/seo.test.ts

Conseils et commandes

Interagir avec Sourcery

  • Déclencher une nouvelle revue : commentez @sourcery-ai review sur la pull request.
  • Poursuivre les discussions : répondez directement aux commentaires de revue de Sourcery.
  • Générer une issue GitHub à partir d’un commentaire de revue : demandez à Sourcery de créer une issue à partir d’un commentaire de revue en y répondant. Vous pouvez également répondre à un commentaire de revue avec @sourcery-ai issue pour créer une issue à partir de celui-ci.
  • Générer un titre de pull request : écrivez @sourcery-ai n’importe où dans le titre de la pull request pour générer un titre à tout moment. Vous pouvez également commenter @sourcery-ai title sur la pull request pour générer ou régénérer le titre à tout moment.
  • Générer un résumé de pull request : écrivez @sourcery-ai summary n’importe où dans le corps de la pull request pour générer un résumé de PR à tout moment, exactement à l’endroit souhaité. Vous pouvez également commenter @sourcery-ai summary sur la pull request pour générer ou régénérer le résumé à tout moment.
  • Générer le guide du réviseur : commentez @sourcery-ai guide sur la pull request pour générer ou régénérer le guide du réviseur à tout moment.
  • Résoudre tous les commentaires de Sourcery : commentez @sourcery-ai resolve sur la pull request pour résoudre tous les commentaires de Sourcery. Utile si vous avez déjà traité tous les commentaires et ne souhaitez plus les voir.
  • Rejeter toutes les revues de Sourcery : commentez @sourcery-ai dismiss sur la pull request pour rejeter toutes les revues existantes de Sourcery. Particulièrement utile si vous souhaitez repartir de zéro avec une nouvelle revue — n’oubliez pas de commenter @sourcery-ai review pour déclencher une nouvelle revue !

Personnaliser votre expérience

Accédez à votre tableau de bord pour :

  • Activer ou désactiver des fonctionnalités de revue telles que le résumé de pull request généré par Sourcery, le guide du réviseur, et d’autres.
  • Modifier la langue de revue.
  • Ajouter, supprimer ou modifier des instructions de revue personnalisées.
  • Ajuster d’autres paramètres de revue.

Obtenir de l’aide

Original review guide in English

Reviewer's Guide

The PR audits and revises landing-page, LLM-facing, documentation, and FAQ claims so they describe shipped functionality accurately, while adding an SEO regression test to prevent privacy-region drift.

Flow diagram for validating public product claims

flowchart LR
    Code[Shipped functionality and configuration] --> Audit[Compare public claims with implementation]
    Audit --> Landing[Landing roadmap and trust badges]
    Audit --> LLM[llms.txt and llms-full.txt]
    Audit --> Docs[Roadmap and launch plan]
    Audit --> FAQ[index.html FAQ JSON-LD]
    FAQ --> SEO[SEO regression test]
    Privacy[PrivacyPolicy.tsx] --> SEO
    SEO --> Match[Region and country remain consistent]
Loading

File-Level Changes

Change Details Files
Correct public roadmap claims to reflect implemented capabilities and current work.
  • Moved disabled LTI 1.3 and browser-incompatible direct OpenAI BYOK out of available features.
  • Replaced overstated WCAG AAA and stale roadmap entries with implemented accessibility, shell-fidelity, curriculum, and platform work.
  • Updated public counters, trust badges, and roadmap documentation timestamps.
src/app/data/landingContent.ts
public/llms.txt
public/llms-full.txt
docs/ROADMAP.md
docs/plan.md
CHANGELOG.md
Align indexed FAQ structured data with the product’s shipped functionality and reviewed privacy information.
  • Described the teacher space as available and LTI as planned rather than nearly finished.
  • Corrected the Supabase region from Frankfurt to eu-west-1 Ireland.
  • Added a regression test requiring the FAQ RGPD answer to match the region and country in the privacy policy.
index.html
src/test/seo.test.ts

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@thierryvm
thierryvm merged commit 238d3aa into main Sep 26, 2026
4 checks passed
@thierryvm
thierryvm deleted the fix/landing-roadmap-accuracy branch September 26, 2026 18:51

This branch was successfully deployed

1 active deployment
Preview — 85bc43cf Deployed Sep 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant