ehsavoie · Aug 28, 2026 · Aug 28, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -86,7 +86,9 @@ The docs site (`docs/`) is built with [Roq](https://docs.quarkiverse.io/quarkus-
 - `index.adoc` (or `index.md`) — the post content, with `image: announce.png` in the YAML frontmatter
 - `announce.png` — the announcement banner image (PNG format, named exactly `announce.png`)
 
-The `announce.png` filename is required: the home page (`docs/content/index.html`) renders the latest post's image using the `post.image` field resolved from this frontmatter entry, and the Roq site theme uses it as the post cover.
+The `announce.png` filename is required. The `image: announce.png` frontmatter field is used by the post card component (on the home page and announces listing) to show the thumbnail. The theme's cover image block is hidden via CSS on post pages, so the image must also be added as the **first line of the post content** (after an empty line following the closing `---`) so it appears after the title:
+- AsciiDoc: blank line after `---`, then `image::announce.png[<alt text>]` (blank line required for block macro recognition)
+- Markdown: blank line after `---`, then `![<alt text>](announce.png)`
 
 **Version metadata:** Each version has a YAML file in `docs/data/versions/` (e.g. `dev.yml`, `1.1.0.Final.yml`) that defines the label, URL path, sort order, default/dev flags, and sidebar menu. When adding or removing a documentation page, update the `menu` list in `docs/data/versions/dev.yml` accordingly.
 

diff --git a/docs/content/index.html b/docs/content/index.html
@@ -50,16 +50,7 @@ <h2>Latest Announcement</h2>
   {#if site.collections.get('posts')}
   {#for post in site.collections.get('posts')}
   {#if post_index == 0}
-  <a href="{post.url}" class="latest-post-banner">
-    <img src="{post.image}" alt="{post.title}" class="latest-post-banner-image">
-    <div class="latest-post-banner-content">
-      <h3 class="latest-post-banner-title">{post.title}</h3>
-      {#if post.data.synopsis??}
-      <p class="latest-post-banner-synopsis">{post.data.synopsis}</p>
-      {/if}
-      <span class="latest-post-banner-cta">Read announcement <i class="fa-solid fa-arrow-right"></i></span>
-    </div>
-  </a>
+  {#roq/postCard post /}
   {/if}
   {/for}
   {/if}

diff --git a/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc b/docs/content/posts/2026-08-07-a2a-java-sdk-1-2-0-final-released/index.adoc
@@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.2.0.Final is now available -- with authorization harde
 author: kkhan
 image: announce.png
 ---
+
 image::announce.png[A2A Java SDK 1.2.0.Final announcement]
 
 I am happy to announce the release of link:https://github.com/a2aproject/a2a-java/releases/tag/v1.2.0.Final[A2A Java SDK 1.2.0.Final]. This release hardens the authorization model, adds stream lifecycle management, and fixes several protocol compliance issues.

diff --git a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/announce.png
diff --git a/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc b/docs/content/posts/2026-08-27-a2a-java-sdk-1-3-0-final-released/index.adoc
@@ -7,6 +7,7 @@ synopsis: 'A2A Java SDK 1.3.0.Final is now available -- with multi-tenancy suppo
 author: ehsavoie
 image: announce.png
 ---
+
 image::announce.png[A2A Java SDK 1.3.0.Final announcement]
 
 I am happy to announce the release of link:https://github.com/a2aproject/a2a-java/releases/tag/v1.3.0.Final[A2A Java SDK 1.3.0.Final]. This release introduces multi-tenancy support, switches the authorization model to fail-closed by default, delivers a wave of security hardening, and improves protocol compliance across all transports.

diff --git a/docs/web/_custom.css b/docs/web/_custom.css
@@ -213,73 +213,10 @@
     text-align: left;
 }
 
-/* ── Latest Announcement banner ──────────────────────────────────────────── */
+/* ── Post page: hide theme cover image (image is inline in content instead) ── */
 
-.latest-post-banner {
-    display: flex;
-    border: 1px solid rgba(255, 255, 255, 0.12);
-    border-radius: 0.75rem;
-    overflow: hidden;
-    text-decoration: none;
-    background: rgba(255, 255, 255, 0.03);
-    transition: border-color 0.2s ease, box-shadow 0.2s ease;
-}
-
-.latest-post-banner:hover {
-    border-color: var(--color-accent-400);
-    box-shadow: 0 4px 20px rgba(63, 81, 181, 0.2);
-    text-decoration: none;
-}
-
-.latest-post-banner-image {
-    width: 45%;
-    object-fit: cover;
-    flex-shrink: 0;
-    display: block;
-}
-
-.latest-post-banner-content {
-    display: flex;
-    flex-direction: column;
-    justify-content: center;
-    padding: 2rem;
-    gap: 1rem;
-    flex: 1;
-}
-
-.latest-post-banner-title {
-    font-size: 1.5rem;
-    font-weight: 700;
-    margin: 0;
-    line-height: 1.3;
-}
-
-.latest-post-banner-synopsis {
-    font-size: 0.95rem;
-    opacity: 0.8;
-    margin: 0;
-    line-height: 1.6;
-}
-
-.latest-post-banner-cta {
-    font-size: 0.9rem;
-    font-weight: 600;
-    color: var(--color-accent-300);
-}
-
-@media (max-width: 640px) {
-    .latest-post-banner {
-        flex-direction: column;
-    }
-
-    .latest-post-banner-image {
-        width: 100%;
-        max-height: 220px;
-    }
-
-    .latest-post-banner-content {
-        padding: 1.25rem;
-    }
+.article-page .page-cover-image {
+    display: none;
 }
 
 /* ── Syntax Highlighting (highlight.js) ───────────────────────────────────── */