Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 8 additions & 10 deletions docs/content/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@
{#title}A2A <span class="shimmer">Java</span> SDK{/title}
{#tagline}Implement the Agent2Agent Protocol in Java{/tagline}
{#subtitle}A multi-module Maven library providing client and server support for A2A agent communication over JSON-RPC, gRPC, and REST transports.{/subtitle}
<a href="/server" class="btn btn-primary">Server Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="/client" class="btn btn-secondary">Client Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="server" class="btn btn-primary">Server Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="client" class="btn btn-secondary">Client Guide <i class="fa-solid fa-arrow-right"></i></a>
Comment on lines +16 to +17

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.

medium

When using relative paths for clean URLs in static sites, it is best practice to include a trailing slash (e.g., server/ instead of server). This prevents the web server from performing an unnecessary 301 redirect to append the trailing slash when resolving the directory.

Additionally, please note that the logo path on line 12 (logo="/images/a2a-java-sdk.png") still uses an absolute path. If this site is hosted on a subpath, the logo image will fail to load. Consider updating it to a relative path as well.

Suggested change
<a href="server" class="btn btn-primary">Server Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="client" class="btn btn-secondary">Client Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="server/" class="btn btn-primary">Server Guide <i class="fa-solid fa-arrow-right"></i></a>
<a href="client/" class="btn btn-secondary">Client Guide <i class="fa-solid fa-arrow-right"></i></a>

{/}

<div class="roq-features">
Expand All @@ -36,14 +36,12 @@
<h2>Quick Install</h2>
<p>Add the A2A Java SDK reference server for JSON-RPC to your Maven project:</p>

```xml
<dependency>
<groupId>org.a2aproject.sdk</groupId>
<artifactId>a2a-java-sdk-reference-jsonrpc</artifactId>
<version>$\{org.a2aproject.sdk.version}</version>
</dependency>
```
<pre><code class="language-xml">&lt;dependency&gt;
&lt;groupId&gt;org.a2aproject.sdk&lt;/groupId&gt;
&lt;artifactId&gt;a2a-java-sdk-reference-jsonrpc&lt;/artifactId&gt;
&lt;version&gt;$\{org.a2aproject.sdk.version}&lt;/version&gt;
&lt;/dependency&gt;</code></pre>

<p>See the <a href="/server">Server Guide</a> and <a href="/client">Client Guide</a> for full setup instructions, or browse <a href="/community">Community Articles</a> for tutorials and examples.</p>
<p>See the <a href="server">Server Guide</a> and <a href="client">Client Guide</a> for full setup instructions, or browse <a href="community">Community Articles</a> for tutorials and examples.</p>

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.

medium

For consistency and to avoid unnecessary 301 redirects, use trailing slashes for these relative links as well.

Suggested change
<p>See the <a href="server">Server Guide</a> and <a href="client">Client Guide</a> for full setup instructions, or browse <a href="community">Community Articles</a> for tutorials and examples.</p>
<p>See the <a href="server/">Server Guide</a> and <a href="client/">Client Guide</a> for full setup instructions, or browse <a href="community/">Community Articles</a> for tutorials and examples.</p>

</section>

6 changes: 6 additions & 0 deletions docs/web/_custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,12 @@
max-width: var(--container-5xl);
}

/* ── Quick Install section ────────────────────────────────────────────────── */

.roq-section pre {
text-align: left;
}

/* ── Syntax Highlighting (highlight.js) ───────────────────────────────────── */

/* Match the site's monospace font (Roboto Mono) */
Expand Down