From 72b09bd300d50ce37286ed390568b3e4e884d479 Mon Sep 17 00:00:00 2001
From: "Laury S." <ginifizz@users.noreply.github.com>
Date: Fri, 12 Jun 2026 16:05:00 +0200
Subject: [PATCH 1/2] Feat: accessibility seo (#681)

* a11y(con): add image alt text and semantic landmarks
* feat(con): add Person & Event/subEvent JSON-LD for speakers and talks
* feat(con): richer semantic HTML for talks & speakers (article, time, section)
---
 .../2025/call-for-papers/components/logos.tsx | 20 +++----
 .../con/2025/tickets/RegisterPage.tsx         |  1 +
 .../2026/call-for-papers/components/logos.tsx | 20 +++----
 pwa/app/(con)/[locale]/con/2026/layout.tsx    | 17 +++++-
 .../[edition]/conferences/ConferencesPage.tsx | 23 ++++---
 .../[slug]/components/ConferencePage.tsx      | 12 ++--
 .../[slug]/components/ConferenceSpeaker.tsx   |  6 +-
 .../con/[edition]/conferences/[slug]/page.tsx |  8 ++-
 .../(con)/[locale]/con/[edition]/layout.tsx   | 21 ++++++-
 .../schedule/components/SlotAvatar.tsx        |  2 +-
 .../schedule/components/SlotItem.tsx          |  4 +-
 .../[edition]/speakers/[slug]/SpeakerPage.tsx | 19 +++---
 .../con/[edition]/speakers/[slug]/page.tsx    | 37 ++++++++++--
 pwa/components/con/home/LastEdition.tsx       |  2 +-
 pwa/components/con/layout/Footer.tsx          |  4 +-
 pwa/components/con/layout/LayoutBase.tsx      |  2 +-
 pwa/components/con/review/ReviewItem.tsx      |  2 +-
 pwa/components/con/speakers/SpeakerImage.tsx  |  5 +-
 .../con/speakers/SpeakerImage2025.tsx         |  2 +-
 pwa/components/con/speakers/SpeakerItem.tsx   |  6 +-
 pwa/utils/con/index.tsx                       | 60 ++++++++++++++++++-
 21 files changed, 204 insertions(+), 69 deletions(-)

diff --git a/pwa/app/(con)/[locale]/con/2025/call-for-papers/components/logos.tsx b/pwa/app/(con)/[locale]/con/2025/call-for-papers/components/logos.tsx
index 2892dd64a..0c1494354 100644
--- a/pwa/app/(con)/[locale]/con/2025/call-for-papers/components/logos.tsx
+++ b/pwa/app/(con)/[locale]/con/2025/call-for-papers/components/logos.tsx
@@ -1,16 +1,16 @@
 export function Logos() {
   return (
     <>
-      <img src="/images/con/2025/cfp/api-platform.png" alt="" />
-      <img src="/images/con/2025/cfp/caddy.png" alt="" />
-      <img src="/images/con/2025/cfp/elastic.png" alt="" />
-      <img src="/images/con/2025/cfp/frankenphp.png" alt="" />
-      <img src="/images/con/2025/cfp/JS.png" alt="" />
-      <img src="/images/con/2025/cfp/laravel.png" alt="" />
-      <img src="/images/con/2025/cfp/php.png" alt="" />
-      <img src="/images/con/2025/cfp/rabbitmq.png" alt="" />
-      <img src="/images/con/2025/cfp/react-admin.png" alt="" />
-      <img src="/images/con/2025/cfp/xdebug.png" alt="" />
+      <img src="/images/con/2025/cfp/api-platform.png" alt="API Platform" />
+      <img src="/images/con/2025/cfp/caddy.png" alt="Caddy" />
+      <img src="/images/con/2025/cfp/elastic.png" alt="Elastic" />
+      <img src="/images/con/2025/cfp/frankenphp.png" alt="FrankenPHP" />
+      <img src="/images/con/2025/cfp/JS.png" alt="JavaScript" />
+      <img src="/images/con/2025/cfp/laravel.png" alt="Laravel" />
+      <img src="/images/con/2025/cfp/php.png" alt="PHP" />
+      <img src="/images/con/2025/cfp/rabbitmq.png" alt="RabbitMQ" />
+      <img src="/images/con/2025/cfp/react-admin.png" alt="React Admin" />
+      <img src="/images/con/2025/cfp/xdebug.png" alt="Xdebug" />
     </>
   );
 }
diff --git a/pwa/app/(con)/[locale]/con/2025/tickets/RegisterPage.tsx b/pwa/app/(con)/[locale]/con/2025/tickets/RegisterPage.tsx
index 10ba5c292..06e9f02b6 100644
--- a/pwa/app/(con)/[locale]/con/2025/tickets/RegisterPage.tsx
+++ b/pwa/app/(con)/[locale]/con/2025/tickets/RegisterPage.tsx
@@ -85,6 +85,7 @@ export default function RegisterPage() {
               <img
                 className="relative"
                 src="/images/con/2024/review/pic-06.jpg"
+                alt="API Platform Conference 2024"
               />
             </div>
             <div className="flex-1 relative bg-white shadow-floating dotted-corner p-12 pt-24 lg:pt-12 lg:pl-24 lg:-translate-x-12 leading-relaxed font-light">
diff --git a/pwa/app/(con)/[locale]/con/2026/call-for-papers/components/logos.tsx b/pwa/app/(con)/[locale]/con/2026/call-for-papers/components/logos.tsx
index 2892dd64a..0c1494354 100644
--- a/pwa/app/(con)/[locale]/con/2026/call-for-papers/components/logos.tsx
+++ b/pwa/app/(con)/[locale]/con/2026/call-for-papers/components/logos.tsx
@@ -1,16 +1,16 @@
 export function Logos() {
   return (
     <>
-      <img src="/images/con/2025/cfp/api-platform.png" alt="" />
-      <img src="/images/con/2025/cfp/caddy.png" alt="" />
-      <img src="/images/con/2025/cfp/elastic.png" alt="" />
-      <img src="/images/con/2025/cfp/frankenphp.png" alt="" />
-      <img src="/images/con/2025/cfp/JS.png" alt="" />
-      <img src="/images/con/2025/cfp/laravel.png" alt="" />
-      <img src="/images/con/2025/cfp/php.png" alt="" />
-      <img src="/images/con/2025/cfp/rabbitmq.png" alt="" />
-      <img src="/images/con/2025/cfp/react-admin.png" alt="" />
-      <img src="/images/con/2025/cfp/xdebug.png" alt="" />
+      <img src="/images/con/2025/cfp/api-platform.png" alt="API Platform" />
+      <img src="/images/con/2025/cfp/caddy.png" alt="Caddy" />
+      <img src="/images/con/2025/cfp/elastic.png" alt="Elastic" />
+      <img src="/images/con/2025/cfp/frankenphp.png" alt="FrankenPHP" />
+      <img src="/images/con/2025/cfp/JS.png" alt="JavaScript" />
+      <img src="/images/con/2025/cfp/laravel.png" alt="Laravel" />
+      <img src="/images/con/2025/cfp/php.png" alt="PHP" />
+      <img src="/images/con/2025/cfp/rabbitmq.png" alt="RabbitMQ" />
+      <img src="/images/con/2025/cfp/react-admin.png" alt="React Admin" />
+      <img src="/images/con/2025/cfp/xdebug.png" alt="Xdebug" />
     </>
   );
 }
diff --git a/pwa/app/(con)/[locale]/con/2026/layout.tsx b/pwa/app/(con)/[locale]/con/2026/layout.tsx
index 8d4c9125f..19f1b2944 100644
--- a/pwa/app/(con)/[locale]/con/2026/layout.tsx
+++ b/pwa/app/(con)/[locale]/con/2026/layout.tsx
@@ -5,8 +5,10 @@ import nav from "data/con/2026/nav";
 import footer from "data/con/2026/footer";
 import { Metadata } from "next";
 import { getEditionEventData } from "utils/con";
-import { i18n } from "i18n/i18n-config";
+import { i18n, Locale } from "i18n/i18n-config";
 import { getRootUrl } from "utils";
+import { getAllSpeakers } from "api/con/speakers";
+import { getAllConferences } from "api/con/conferences";
 
 type Props = {
   params: { edition: string; locale: string };
@@ -38,8 +40,17 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
   };
 }
 
-function EditionLayout({ children }: { children: React.ReactNode }) {
-  const eventData = getEditionEventData("2026");
+async function EditionLayout({
+  children,
+  params,
+}: {
+  children: React.ReactNode;
+  params: { locale: string };
+}) {
+  const locale = (params?.locale || i18n.defaultLocale) as Locale;
+  const speakers = await getAllSpeakers("2026", locale);
+  const talks = await getAllConferences("2026", true, locale);
+  const eventData = getEditionEventData("2026", speakers, talks);
   return (
     <LayoutBase edition="2026" nav={nav} footer={footer} isTicketingOpen>
       <script
diff --git a/pwa/app/(con)/[locale]/con/[edition]/conferences/ConferencesPage.tsx b/pwa/app/(con)/[locale]/con/[edition]/conferences/ConferencesPage.tsx
index c045ab311..cc66d15c1 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/conferences/ConferencesPage.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/conferences/ConferencesPage.tsx
@@ -141,7 +141,7 @@ export default function SpeakerPageListTemplate({
             {conferences.map((conference, i) => {
               const day = days.find((day: Day) => day.date === conference.date);
               return (
-                <div
+                <article
                   key={conference.title}
                   className="flex flex-col-reverse md:flex-row text-center md:text-left gap-4 md:gap-12 bg-white p-4 pt-8 sm:p-8 text-blue-black relative"
                 >
@@ -206,6 +206,7 @@ export default function SpeakerPageListTemplate({
                           <SpeakerImage
                             image={speaker.image}
                             placeholder={speaker.placeholder}
+                            alt={speaker.name}
                           />
                         </div>
                       );
@@ -260,11 +261,19 @@ export default function SpeakerPageListTemplate({
                       ) : null}
                       {conference.date ? (
                         <p className="text-sm font-title">
-                          {getConferenceDate(
-                            conference.date,
-                            conference.start,
-                            conference.end
-                          )}
+                          <time
+                            dateTime={
+                              conference.start
+                                ? `${conference.date}T${conference.start}`
+                                : conference.date
+                            }
+                          >
+                            {getConferenceDate(
+                              conference.date,
+                              conference.start,
+                              conference.end
+                            )}
+                          </time>
                         </p>
                       ) : null}
                     </>
@@ -283,7 +292,7 @@ export default function SpeakerPageListTemplate({
                       />
                     ) : null}
                   </div>
-                </div>
+                </article>
               );
             })}
           </div>
diff --git a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferencePage.tsx b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferencePage.tsx
index 0169d8d74..041ddce80 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferencePage.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferencePage.tsx
@@ -18,8 +18,8 @@ const ConferencePageTemplate = ({ conference, day }: ConferencePageProps) => {
   const languageContext = useContext(LanguageContext);
 
   return (
-    <div className="container max-w-6xl flex flex-col items-center pt-10 pb-80 before:bg-wave before:absolute before:w-[2000px] before:h-[500px] before:bg-no-repeat before:opacity-30 before:-translate-x-1/2 before:top-[220px] before:left-[65%] | sm:pt-20">
-      <div className="text-white text-center mb-20">
+    <article className="container max-w-6xl flex flex-col items-center pt-10 pb-80 before:bg-wave before:absolute before:w-[2000px] before:h-[500px] before:bg-no-repeat before:opacity-30 before:-translate-x-1/2 before:top-[220px] before:left-[65%] | sm:pt-20">
+      <header className="text-white text-center mb-20">
         <SectionTitle dark lined h1 small={50 < title.length}>
           <strong>{title}</strong>
         </SectionTitle>
@@ -34,11 +34,13 @@ const ConferencePageTemplate = ({ conference, day }: ConferencePageProps) => {
           ) : null}
           {date ? (
             <p className="text-sm font-semibold mt-3">
-              {getConferenceDate(date, start, end)}
+              <time dateTime={start ? `${date}T${start}` : date}>
+                {getConferenceDate(date, start, end)}
+              </time>
             </p>
           ) : null}
         </>
-      </div>
+      </header>
       <div className="flex flex-col-reverse items-center w-full relative -mb-24 before:bg-grey before:absolute before:w-screen before:h-4/6 before:left-1/2 before:bottom-[50px] before:-translate-x-1/2 | md:flex-row md:items-start">
         <ConferenceSpeaker conference={conference} />
         <div className="bg-white p-12 shadow-md dotted-corner corner-bottom flex-1">
@@ -53,7 +55,7 @@ const ConferencePageTemplate = ({ conference, day }: ConferencePageProps) => {
           ) : null}
         </div>
       </div>
-    </div>
+    </article>
   );
 };
 
diff --git a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferenceSpeaker.tsx b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferenceSpeaker.tsx
index 1da303875..bba614dc9 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferenceSpeaker.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/components/ConferenceSpeaker.tsx
@@ -51,7 +51,11 @@ const ConferenceSpeaker = ({ conference }: SpeakerProps) => {
                       placeholder={placeholder}
                     />
                   ) : (
-                    <SpeakerImage image={image} placeholder={placeholder} />
+                    <SpeakerImage
+                      image={image}
+                      placeholder={placeholder}
+                      alt={name}
+                    />
                   )}
                 </div>
 
diff --git a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/page.tsx b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/page.tsx
index 99f315b25..801f1718b 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/page.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/conferences/[slug]/page.tsx
@@ -30,7 +30,9 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
     .replace("%name%", SPEAKERS)
     .replace("%edition%", params.edition);
 
-  const URL = `${getRootUrl()}/${params.locale}/con/${params.edition}/${params.slug}`;
+  const URL = `${getRootUrl()}/${params.locale}/con/${params.edition}/${
+    params.slug
+  }`;
 
   return {
     title: conference.title,
@@ -39,13 +41,13 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
       title: `${conference.title} - API Platform Conference`,
       description: DESCRIPTION,
       url: URL,
-      type: 'website',
+      type: "website",
       images: [
         {
           url: `${getRootUrl()}/images/con/og-${params.edition}.png`,
           width: 1200,
           height: 630,
-          alt: `API Platform Conference ${params.edition}`
+          alt: `API Platform Conference ${params.edition}`,
         },
       ],
     },
diff --git a/pwa/app/(con)/[locale]/con/[edition]/layout.tsx b/pwa/app/(con)/[locale]/con/[edition]/layout.tsx
index aaaf867c3..dcf6dd5cd 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/layout.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/layout.tsx
@@ -3,8 +3,11 @@ import LayoutBase from "components/con/layout/LayoutBase";
 import ContactCard from "components/con/layout/ContactCard";
 import type { Metadata } from "next";
 import { getEditionEventData } from "utils/con";
-import { i18n } from "i18n/i18n-config";
+import { i18n, Locale } from "i18n/i18n-config";
 import { getRootUrl } from "utils";
+import { getAllSpeakers } from "api/con/speakers";
+import { getAllConferences } from "api/con/conferences";
+import { currentEdition } from "data/con/editions";
 
 type Props = {
   params: { edition: string; locale: string };
@@ -68,13 +71,25 @@ async function EditionLayout({
   children: React.ReactNode;
   params: {
     edition: string;
+    locale: string;
   };
 }) {
-  const { edition } = params;
+  const { edition, locale } = params;
   const nav = await import(`data/con/${edition}/nav`);
   const footer = await import(`data/con/${edition}/footer`);
 
-  const eventData = getEditionEventData(edition);
+  const resolvedLocale = (locale || i18n.defaultLocale) as Locale;
+  // Only the upcoming edition benefits from rich speaker/talk structured data
+  // (Google does not surface past events). Skipping the fetch for past
+  // editions keeps the build lean.
+  const isCurrentEdition = edition === currentEdition;
+  const speakers = isCurrentEdition
+    ? await getAllSpeakers(edition, resolvedLocale)
+    : [];
+  const talks = isCurrentEdition
+    ? await getAllConferences(edition, true, resolvedLocale)
+    : [];
+  const eventData = getEditionEventData(edition, speakers, talks);
 
   return (
     <LayoutBase edition={edition} nav={nav.default} footer={footer.default}>
diff --git a/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotAvatar.tsx b/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotAvatar.tsx
index c5280d042..75c7c7779 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotAvatar.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotAvatar.tsx
@@ -48,7 +48,7 @@ export default function Avatar({
         ) : (
           <Image
             key={speaker.name}
-            alt=""
+            alt={speaker.name}
             className="absolute rounded-full -translate-x-1/2 -translate-y-1/2 object-cover"
             src={speaker.image}
             width={getSize(speakers.length)}
diff --git a/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotItem.tsx b/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotItem.tsx
index bcc24123c..48d65420f 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotItem.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/schedule/components/SlotItem.tsx
@@ -35,7 +35,9 @@ export default function SlotItem({ conference, id }: SlotItemProps) {
             : null}
         </div>
         <Overline className="opacity-70 lg:hidden">
-          {getConferenceTimes(date, start, end)}
+          <time dateTime={`${date}T${start}`}>
+            {getConferenceTimes(date, start, end)}
+          </time>
         </Overline>
         <h3 className="font-title font-bold lined-left leading-tight">
           {title}
diff --git a/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/SpeakerPage.tsx b/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/SpeakerPage.tsx
index b7335454d..3172fc887 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/SpeakerPage.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/SpeakerPage.tsx
@@ -29,8 +29,8 @@ export default function SpeakerPageTemplate({
 
   return (
     <>
-      <div className="container xl:max-w-8xl flex flex-col items-center pt-10 pb-32 | sm:pt-20">
-        <div className="text-white pb-14">
+      <article className="container xl:max-w-8xl flex flex-col items-center pt-10 pb-32 | sm:pt-20">
+        <header className="text-white pb-14">
           <SectionTitle h1 dark lined>
             <strong>{name}</strong>
           </SectionTitle>
@@ -43,7 +43,7 @@ export default function SpeakerPageTemplate({
               </>
             ) : null}
           </p>
-        </div>
+        </header>
         <div className="flex flex-col relative flex-wrap items-center bg-grey px-10 pb-10 pt-28 | lg:flex-row lg:items-start | sm:pb-20">
           <div className="w-72 h-72 | md:w-80 md:h-80 | lg:w-[400px] lg:h-[400px]">
             {edition === "2025" || edition === "2026" ? (
@@ -54,7 +54,12 @@ export default function SpeakerPageTemplate({
                 placeholder={placeholder}
               />
             ) : (
-              <SpeakerImage big image={image} placeholder={placeholder} />
+              <SpeakerImage
+                big
+                image={image}
+                placeholder={placeholder}
+                alt={name}
+              />
             )}
           </div>
           <div className="flex-1 | sm:px-6">
@@ -74,8 +79,8 @@ export default function SpeakerPageTemplate({
             </div>
           ) : null}
         </div>
-      </div>
-      <div className="container flex flex-col items-center pt-12 pb-44 max-w-6xl text-white">
+      </article>
+      <section className="container flex flex-col items-center pt-12 pb-44 max-w-6xl text-white">
         <div className="lined-center lined-blue font-bold uppercase text-2xl text-white font-title">
           <Translate translationKey="speakers.others" />
         </div>
@@ -88,7 +93,7 @@ export default function SpeakerPageTemplate({
         >
           {t("speakers.see_all")}
         </Button>
-      </div>
+      </section>
     </>
   );
 }
diff --git a/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/page.tsx b/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/page.tsx
index bb29d1ce9..226535479 100644
--- a/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/page.tsx
+++ b/pwa/app/(con)/[locale]/con/[edition]/speakers/[slug]/page.tsx
@@ -79,12 +79,37 @@ export default async function Page({ params }: Props) {
     params.locale as Locale
   );
 
+  const rootUrl = getRootUrl();
+  const personData = {
+    "@context": "https://schema.org",
+    "@type": "Person",
+    name: speaker.name,
+    ...(speaker.job ? { jobTitle: speaker.job } : {}),
+    ...(speaker.company
+      ? { worksFor: { "@type": "Organization", name: speaker.company } }
+      : {}),
+    image: `${rootUrl}${speaker.image}`,
+    url: `${rootUrl}${speaker.url}`,
+    sameAs: [
+      speaker.github,
+      speaker.twitter,
+      speaker.mastodon,
+      speaker.bluesky,
+    ].filter(Boolean),
+  };
+
   return (
-    <SpeakerPage
-      speakerData={speaker}
-      conferences={conferences}
-      edition={params.edition}
-      otherSpeakers={otherSpeakers}
-    />
+    <>
+      <script
+        type="application/ld+json"
+        dangerouslySetInnerHTML={{ __html: JSON.stringify(personData) }}
+      />
+      <SpeakerPage
+        speakerData={speaker}
+        conferences={conferences}
+        edition={params.edition}
+        otherSpeakers={otherSpeakers}
+      />
+    </>
   );
 }
diff --git a/pwa/components/con/home/LastEdition.tsx b/pwa/components/con/home/LastEdition.tsx
index 1b5a0c176..c2ad383cd 100644
--- a/pwa/components/con/home/LastEdition.tsx
+++ b/pwa/components/con/home/LastEdition.tsx
@@ -44,7 +44,7 @@ export default function LastEdition({
           <Image
             fill
             sizes="(max-width: 640px) 200px, (max-width: 768px) 240px, (max-width: 1536px) 300px, 400px"
-            alt=""
+            alt={`API Platform Conference ${edition}`}
             key={`pic${i}`}
             src={`/images/con/${edition}/pic-0${i + 1}.jpg`}
           />
diff --git a/pwa/components/con/layout/Footer.tsx b/pwa/components/con/layout/Footer.tsx
index f5cb53094..7a7f37726 100644
--- a/pwa/components/con/layout/Footer.tsx
+++ b/pwa/components/con/layout/Footer.tsx
@@ -21,7 +21,7 @@ export default function Footer({
 }: FooterProps) {
   const { t, locale } = useContext(LanguageContext);
   return (
-    <div className="text-white w-full relative overflow-hidden">
+    <footer className="text-white w-full relative overflow-hidden">
       <div className="container flex flex-col min-h-[500px] pt-48 z-10">
         <div className="flex flex-col items-center mt-16 p-5 flex-wrap w-full | lg:flex-row lg:items-start lg:gap-16">
           <div className="flex items-center justify-center flex-col mb-5 | lg:mb-0 lg:mr-auto ">
@@ -126,6 +126,6 @@ export default function Footer({
         </span>
       </div>
       <Wave className="absolute w-[1200px] max-w-7xl -top-28 left-1/2 -translate-x-1/2 opacity-50 | xl:w-full" />
-    </div>
+    </footer>
   );
 }
diff --git a/pwa/components/con/layout/LayoutBase.tsx b/pwa/components/con/layout/LayoutBase.tsx
index d6fc08821..c31db44b5 100644
--- a/pwa/components/con/layout/LayoutBase.tsx
+++ b/pwa/components/con/layout/LayoutBase.tsx
@@ -25,7 +25,7 @@ export default function LayoutBase({
       <Nav edition={edition} nav={nav} isTicketingOpen={isTicketingOpen} />
       <MobileNav nav={nav} edition={edition} />
       <div className="relative z-10">
-        {children}
+        <main>{children}</main>
         <Footer
           links={footer}
           withSocial={withSocialFooter}
diff --git a/pwa/components/con/review/ReviewItem.tsx b/pwa/components/con/review/ReviewItem.tsx
index 5a3fa688d..ed4cb55f4 100644
--- a/pwa/components/con/review/ReviewItem.tsx
+++ b/pwa/components/con/review/ReviewItem.tsx
@@ -53,7 +53,7 @@ export default function ReviewItem({
         >
           <Image
             src={`/images/con/${edition}/review/${imageId}.jpg`}
-            alt=""
+            alt={`API Platform Conference ${edition}`}
             fill
             sizes="(max-width: 640px) 80vw, (max-width: 1024px) 360px, 500px"
             className="object-cover"
diff --git a/pwa/components/con/speakers/SpeakerImage.tsx b/pwa/components/con/speakers/SpeakerImage.tsx
index 3054e4867..736f58116 100644
--- a/pwa/components/con/speakers/SpeakerImage.tsx
+++ b/pwa/components/con/speakers/SpeakerImage.tsx
@@ -7,6 +7,8 @@ interface SpeakerImageProps {
   placeholder?: string;
   hoverable?: boolean;
   big?: boolean;
+  /** Accessible name for the photo (usually the speaker's name). Leave empty for decorative placeholders. */
+  alt?: string;
 }
 
 export default function SpeakerImage({
@@ -14,6 +16,7 @@ export default function SpeakerImage({
   placeholder,
   big = false,
   hoverable = true,
+  alt = "",
 }: SpeakerImageProps) {
   return (
     <div className="w-full h-full relative">
@@ -33,7 +36,7 @@ export default function SpeakerImage({
           <Image
             src={image}
             className="rounded-full object-cover"
-            alt=""
+            alt={alt}
             fill
             sizes={big ? "(max-width: 768px) 240px, 440px" : "240px"}
             loading="lazy"
diff --git a/pwa/components/con/speakers/SpeakerImage2025.tsx b/pwa/components/con/speakers/SpeakerImage2025.tsx
index aae6a1fdc..fdf73e61b 100644
--- a/pwa/components/con/speakers/SpeakerImage2025.tsx
+++ b/pwa/components/con/speakers/SpeakerImage2025.tsx
@@ -106,7 +106,7 @@ export default function SpeakerImage({
                   big && "scale-110",
                   hoverable && "group-hover:-rotate-2 group-hover:scale-110 "
                 )}
-                alt=""
+                alt={speaker.name}
                 fill
                 sizes={big ? "(max-width: 768px) 350px, 600px" : "350px"}
                 placeholder={
diff --git a/pwa/components/con/speakers/SpeakerItem.tsx b/pwa/components/con/speakers/SpeakerItem.tsx
index 89c9b6786..dcf8ce174 100644
--- a/pwa/components/con/speakers/SpeakerItem.tsx
+++ b/pwa/components/con/speakers/SpeakerItem.tsx
@@ -27,7 +27,7 @@ export default function SpeakerItem({
   const edition = speaker.edition;
 
   return (
-    <div
+    <article
       className={classNames(
         "flex flex-col text-center",
         minified && "w-full max-w-xs"
@@ -55,7 +55,7 @@ export default function SpeakerItem({
           <div
             className={classNames(minified ? "w-20 h-20" : "mx-auto w-60 h-60")}
           >
-            <SpeakerImage image={image} placeholder={placeholder} />
+            <SpeakerImage image={image} placeholder={placeholder} alt={name} />
           </div>
         )}
 
@@ -85,6 +85,6 @@ export default function SpeakerItem({
         </div>
       </Link>
       {withSocial && !minified ? <SpeakerSocialList speaker={speaker} /> : null}
-    </div>
+    </article>
   );
 }
diff --git a/pwa/utils/con/index.tsx b/pwa/utils/con/index.tsx
index 168b9259c..4155eef00 100644
--- a/pwa/utils/con/index.tsx
+++ b/pwa/utils/con/index.tsx
@@ -1,4 +1,4 @@
-import { Conference } from "types/con";
+import { Conference, Speaker } from "types/con";
 import dayjs from "dayjs";
 import humanizeDuration from "./humanize-duration";
 import { editions } from "data/con/editions";
@@ -84,8 +84,13 @@ export function localeDuration(
   return humanizeDuration(ms, params);
 }
 
-export function getEditionEventData(edition: string) {
+export function getEditionEventData(
+  edition: string,
+  speakers: Speaker[] = [],
+  talks: Conference[] = []
+) {
   const currentEdition = editions.find((e) => e.year === edition);
+  const rootUrl = getRootUrl();
 
   const eventData = {
     "@context": "https://schema.org",
@@ -121,7 +126,58 @@ export function getEditionEventData(edition: string) {
       },
     ],
     image: `${getRootUrl()}/images/con/og-${edition}`,
+    ...(speakers.length
+      ? {
+          performer: speakers.map((speaker) => ({
+            "@type": "Person",
+            name: speaker.name,
+            ...(speaker.job ? { jobTitle: speaker.job } : {}),
+            image: `${rootUrl}${speaker.image}`,
+            url: `${rootUrl}${speaker.url}`,
+          })),
+        }
+      : {}),
+    ...(talks.length
+      ? { subEvent: talks.map((talk) => getTalkSubEventData(talk, rootUrl)) }
+      : {}),
   };
 
   return eventData;
 }
+
+/**
+ * schema.org structured data for a single talk, modeled as a nested `Event`
+ * (no `@context` — it is embedded as a `subEvent` of the edition's conference).
+ */
+function getTalkSubEventData(conference: Conference, rootUrl: string) {
+  const { date, start, end, title } = conference;
+
+  const description = (conference.short || conference.description || "")
+    .replace(/<[^>]*>/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+
+  const talkUrl = conference.url ? `${rootUrl}${conference.url}` : undefined;
+
+  return {
+    "@type": "Event",
+    name: title,
+    ...(description ? { description } : {}),
+    ...(date && start ? { startDate: `${date}T${start}:00` } : {}),
+    ...(date && end ? { endDate: `${date}T${end}:00` } : {}),
+    eventStatus: "https://schema.org/EventScheduled",
+    eventAttendanceMode: "https://schema.org/OfflineEventAttendanceMode",
+    ...(talkUrl ? { url: talkUrl } : {}),
+    ...(conference.speakers?.length
+      ? {
+          performer: conference.speakers.map((speaker) => ({
+            "@type": "Person",
+            name: speaker.name,
+            ...(speaker.job ? { jobTitle: speaker.job } : {}),
+            ...(speaker.image ? { image: `${rootUrl}${speaker.image}` } : {}),
+            ...(speaker.url ? { url: `${rootUrl}${speaker.url}` } : {}),
+          })),
+        }
+      : {}),
+  };
+}

From 07c3b85e0f03daccb288a189b04fc3dcd80a68db Mon Sep 17 00:00:00 2001
From: Antoine Bluchet <soyuka@users.noreply.github.com>
Date: Sun, 14 Jun 2026 09:28:09 +0200
Subject: [PATCH 2/2] feat: advertise API Platform skillset (help page +
 footer) (#682)

---
 pwa/app/(common)/help/page.tsx | 27 +++++++++++++++++++++++++++
 pwa/data/footer.ts             |  4 ++++
 2 files changed, 31 insertions(+)

diff --git a/pwa/app/(common)/help/page.tsx b/pwa/app/(common)/help/page.tsx
index ae93e323d..bd993fd2c 100644
--- a/pwa/app/(common)/help/page.tsx
+++ b/pwa/app/(common)/help/page.tsx
@@ -170,6 +170,33 @@ export default async function Page() {
           />
         </div>
       </div>
+      <div>
+        <div className="container xl:max-w-5xl flex flew-row items-center relative gap-16 py-12">
+          <div className="flex-1 max-w-2xl py-6 mx-auto text-center">
+            <Heading size="lg" level="h2" overline="AI coding agents">
+              Teach AI agents the <strong>canonical way</strong>
+            </Heading>
+            <p className="mt-4">
+              The API Platform Skillset teaches AI coding agents the canonical
+              API Platform 4.x way, with 15 skills covering both Symfony and
+              Laravel. Install the Claude Code plugin to keep your agents
+              aligned with framework best practices.
+            </p>
+            <div className="mt-6 flex flex-wrap justify-center gap-4">
+              <Button
+                external
+                href="https://github.com/api-platform/skillset"
+                size="medium"
+              >
+                Get the skillset
+              </Button>
+              <Button href="/docs/core/ai-agents" size="medium" empty>
+                Learn more
+              </Button>
+            </div>
+          </div>
+        </div>
+      </div>
       <div className="bg-blue-extralight/50 dark:bg-blue-dark dark:text-white after:absolute after:w-full after:h-80 after:top-full after:left-0 after:bg-blue-extralight/50 after:dark:bg-blue-dark">
         <div className="container xl:max-w-5xl flex flew-row items-center relative gap-16 pt-12">
           <img
diff --git a/pwa/data/footer.ts b/pwa/data/footer.ts
index 06b6563b3..85fbfae00 100644
--- a/pwa/data/footer.ts
+++ b/pwa/data/footer.ts
@@ -30,6 +30,10 @@ const footer: FooterPart[] = [
         title: "Screencasts",
         url: "https://symfonycasts.com/screencast/api-platform?cid=apip",
       },
+      {
+        title: "AI coding-agent skills",
+        url: "/docs/core/ai-agents/",
+      },
       {
         title: "Stack Overflow",
         url: "https://stackoverflow.com/questions/tagged/api-platform.com",