From 10e22df9bd0ffbbcc6397c7b1acd15adb5b774c3 Mon Sep 17 00:00:00 2001 From: Ben Clarke Date: Wed, 3 Jun 2026 17:17:04 +0100 Subject: [PATCH 1/3] docs: add A2A & generative UI hackathon banner Add an announcement banner promoting the A2A and generative UI hackathon in London on Saturday 13th June, linking to the Luma signup page. The existing DeepLearning.AI course banner is commented out for now and can be uncommented after the hackathon to restore it. Scope the supporting CSS to a new `.md-banner__hackathon` class with `:has()` so the layout (right-aligned compact button, vertically-centered dismiss icon) only applies while the hackathon paragraph is present. When the hackathon banner is later removed, the styles become inert and the restored course banner renders with its original default Material appearance. Co-Authored-By: Claude Opus 4.8 --- .mkdocs/overrides/main.html | 8 ++++++++ docs/stylesheets/custom.css | 28 ++++++++++++++++++++++++---- 2 files changed, 32 insertions(+), 4 deletions(-) diff --git a/.mkdocs/overrides/main.html b/.mkdocs/overrides/main.html index 853502090..eff3f004e 100644 --- a/.mkdocs/overrides/main.html +++ b/.mkdocs/overrides/main.html @@ -1,8 +1,16 @@ {% extends "base.html" %} {% block announce %} +

+ Sign up to the A2A and generative UI hackathon in London on Saturday 13th June! + + Sign up + +

+ {% endblock %} diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css index 0f201b0c9..5d0d00374 100644 --- a/docs/stylesheets/custom.css +++ b/docs/stylesheets/custom.css @@ -70,10 +70,30 @@ line-height: 1.4; } -.announce .md-button { - font-size: 0.8em; - padding: 0.3em 1em; - margin-left: 0.5em; +.md-banner__inner:has(.md-banner__hackathon) { + display: grid; + grid-template-columns: 1fr auto; + column-gap: 0.8em; + align-items: center; +} + +.md-banner__hackathon { + grid-column: 1; + display: flex; + align-items: center; + gap: 1em; + margin: 0; +} + +.md-banner__hackathon .md-button { + margin-left: auto; + padding: 0.2em 0.6em; +} + +.md-banner__inner:has(.md-banner__hackathon) .md-banner__button { + grid-column: 2; + grid-row: 1 / -1; + align-self: center; } h1#agent2agent-a2a-protocol { From 897443ae4e7740280c5403092ed8f561333783e0 Mon Sep 17 00:00:00 2001 From: Ben Clarke Date: Wed, 3 Jun 2026 18:38:14 +0100 Subject: [PATCH 2/3] docs: appease spelling and CSS linters - Add `luma` (from luma.com URL) to spell-check expect list. - Disable stylelint `selector-class-pattern` around the announcement rules, since Material's banner classes use BEM `__` selectors that the rule rejects. Co-Authored-By: Claude Opus 4.8 --- .github/actions/spelling/expect.txt | 1 + docs/stylesheets/custom.css | 2 ++ 2 files changed, 3 insertions(+) diff --git a/.github/actions/spelling/expect.txt b/.github/actions/spelling/expect.txt index 73ff97327..94f1e4d21 100644 --- a/.github/actions/spelling/expect.txt +++ b/.github/actions/spelling/expect.txt @@ -1,5 +1,6 @@ Abhimanyu lfx +luma Petschulat SFDC Siwach diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css index 5d0d00374..783c69ba3 100644 --- a/docs/stylesheets/custom.css +++ b/docs/stylesheets/custom.css @@ -70,6 +70,7 @@ line-height: 1.4; } +/* stylelint-disable selector-class-pattern -- Material uses BEM `__` class names */ .md-banner__inner:has(.md-banner__hackathon) { display: grid; grid-template-columns: 1fr auto; @@ -95,6 +96,7 @@ grid-row: 1 / -1; align-self: center; } +/* stylelint-enable selector-class-pattern */ h1#agent2agent-a2a-protocol { display: none; From b0eb69408e4d6f996250808706295eebe3f07b81 Mon Sep 17 00:00:00 2001 From: Ben Clarke Date: Fri, 5 Jun 2026 13:12:55 +0100 Subject: [PATCH 3/3] docs: generalize announcement-bar styling Drop the `.md-banner__hackathon` scope so the layout applies to any future announcement, not just the hackathon one. The commented-out course banner is updated to follow the same `

` + `` markup convention so it can be uncommented later without further changes. Co-Authored-By: Claude Opus 4.8 --- .mkdocs/overrides/main.html | 12 +++++++----- docs/stylesheets/custom.css | 13 ++++++++----- 2 files changed, 15 insertions(+), 10 deletions(-) diff --git a/.mkdocs/overrides/main.html b/.mkdocs/overrides/main.html index eff3f004e..fc33a1819 100644 --- a/.mkdocs/overrides/main.html +++ b/.mkdocs/overrides/main.html @@ -1,16 +1,18 @@ {% extends "base.html" %} {% block announce %} -

+

Sign up to the A2A and generative UI hackathon in London on Saturday 13th June! Sign up

{% endblock %} diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css index 783c69ba3..f86b619c7 100644 --- a/docs/stylesheets/custom.css +++ b/docs/stylesheets/custom.css @@ -70,15 +70,18 @@ line-height: 1.4; } -/* stylelint-disable selector-class-pattern -- Material uses BEM `__` class names */ -.md-banner__inner:has(.md-banner__hackathon) { +/* Announcement bar: right-align the call-to-action button and vertically + center both it and the dismiss icon. Each announcement is wrapped in a +

. Material uses BEM `__` class names, hence the stylelint exception. */ +/* stylelint-disable selector-class-pattern */ +.md-banner__inner { display: grid; grid-template-columns: 1fr auto; column-gap: 0.8em; align-items: center; } -.md-banner__hackathon { +.md-banner__inner > p { grid-column: 1; display: flex; align-items: center; @@ -86,12 +89,12 @@ margin: 0; } -.md-banner__hackathon .md-button { +.md-banner__inner .md-button { margin-left: auto; padding: 0.2em 0.6em; } -.md-banner__inner:has(.md-banner__hackathon) .md-banner__button { +.md-banner__button { grid-column: 2; grid-row: 1 / -1; align-self: center;