Skip to content

docs: add RSS subscriptions for announcements - #1284

Merged
kabir merged 1 commit into
a2aproject:mainfrom
kabir:rss
Nov 3, 2026
Merged

kabir merged 1 commit into
a2aproject:mainfrom
kabir:rss

Conversation

@kabir

@kabir kabir commented Nov 3, 2026

Copy link
Copy Markdown
Collaborator

Description

Readers can subscribe to website announcements at /rss.xml. Use Roq’s built-in RSS template to generate entries with 150-word excerpts from the existing posts; the theme automatically adds feed discovery metadata. Add a visible RSS subscription link and GitHub release notification instructions to the announcements page.

Validation

  • Generated the site successfully with Java 21 and the deployed /a2a-java root path, temporarily excluding versioned Javadocs using -Dsite.ignored-files=**/apidocs/**.
  • Parsed the generated RSS XML and verified all five announcements, excerpts, date order, unique IDs, and links to generated posts. Checked the visible subscription link and feed discovery metadata on the announcements, home, and dev documentation pages.
  • git diff --check passed.

The full site build fails with ClassTooLargeException in RoqGeneratorProcessor$initStaticFiles while packaging the large static file collection. Reproduced the same failure with the RSS file disabled; the Javadoc exclusion is only a local validation option and is not committed.

@kabir
kabir merged commit e5483dd into a2aproject:main Nov 3, 2026
3 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.

2 participants