Skip to content

docs: add A2A & generative UI hackathon banner#1906

Merged
msampathkumar merged 4 commits into
a2aproject:mainfrom
benclarkeio:docs/london-hackathon-banner
Jun 5, 2026
Merged

docs: add A2A & generative UI hackathon banner#1906
msampathkumar merged 4 commits into
a2aproject:mainfrom
benclarkeio:docs/london-hackathon-banner

Conversation

@benclarkeio

@benclarkeio benclarkeio commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Summary

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 so a single, focused announcement is shown for the next 10 days. After the hackathon, removing the hackathon <p> and uncommenting the original course banner restores the previous state exactly — see "Future state" below.

Changes

Only two files are touched:

  • .mkdocs/overrides/main.html — add a new <p class="md-banner__hackathon"> for the hackathon announcement; comment out the previous course-banner content.
  • docs/stylesheets/custom.css — replace the previously dead .announce .md-button rule with a :has(.md-banner__hackathon)-scoped layout that right-aligns the announcement button (with smaller padding) and vertically centers the dismiss icon.

Before / After

Before (current production banner)

Screenshot 2026-06-03 at 18 04 35

After (this PR)

Screenshot 2026-06-03 at 18 07 51

Future state (after the hackathon)

The CSS is scoped via :has(.md-banner__hackathon), so when the hackathon paragraph is later removed and the course banner is uncommented, all custom styling becomes inert and the course banner renders exactly as it did before this PR (default Material styling, big inline "Enroll for free" button, ✕ floated top-right). Verified locally by reverting the template to its pre-PR contents — the page rendered identically to the current production site.

Dismiss behaviour

Material's announce.dismiss keys dismissal off a hash of the announce block's HTML, so users who previously dismissed the course banner will still see the new hackathon banner (different content → different hash → different dismissal state). The same applies when the course banner is reinstated after the hackathon.

Test plan

  • Build the docs locally with ./scripts/build_docs.sh — no warnings introduced.
  • Serve with mkdocs serve and verify the hackathon banner renders with the button right-aligned, vertically centered, and the ✕ vertically centered with a small gap (see "After" screenshot).
  • Simulate the post-hackathon state by reverting .mkdocs/overrides/main.html to its pre-PR contents; confirm the page renders identically to the current production site (default Material banner styling).
  • Confirm custom.css changes don't affect any other .md-button on the site — the new selectors are all scoped under .md-banner__inner:has(.md-banner__hackathon) / .md-banner__hackathon.

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 <noreply@anthropic.com>
@benclarkeio benclarkeio requested review from a team as code owners June 3, 2026 17:13

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

This pull request replaces the DeepLearning.AI course announcement banner with a new banner promoting the "A2A and generative UI hackathon" in London, along with corresponding CSS updates for layout and responsiveness. The reviewer suggested several improvements: adding flex-wrap: wrap and flex-shrink: 0 to the CSS to prevent layout overflow on smaller screens, adding target="_blank" and rel="noopener" to the external Luma link to open it in a new tab, and using Jinja2 comments ({# ... #}) instead of HTML comments to completely omit the commented-out block from the rendered output.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/stylesheets/custom.css Outdated
Comment thread .mkdocs/overrides/main.html
Comment thread .mkdocs/overrides/main.html
- 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 <noreply@anthropic.com>
@benclarkeio

Copy link
Copy Markdown
Contributor Author

Note on the failing Check linked issues check: there's no existing issue tracking this hackathon announcement, so I haven't linked one. The workflow allows bypassing via the no-issue label (per skip-linked-issues-check-label: no-issue) — could a maintainer apply that if appropriate? Happy to open a tracking issue first if you'd prefer.

(The spelling and Lint Code Base failures are addressed in the follow-up commit 897443a.)

@muscariello muscariello left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

muscariello and others added 2 commits June 5, 2026 10:08
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 `<p>` + `<span>` markup
convention so it can be uncommented later without further changes.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@msampathkumar msampathkumar left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM.

@msampathkumar msampathkumar merged commit 2e0a4e5 into a2aproject:main Jun 5, 2026
5 of 6 checks passed
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.

3 participants