docs: Fix typos and linguistic errors in documentation / hacktoberfest (#343)

# Description

Fix typos and linguistic errors in documentation. It's not much but I'm
happy to help

Thank you for opening a Pull Request!
Before submitting your PR, there are a few things you can do to make
sure it goes smoothly:

- [X ] Follow the [`CONTRIBUTING` Guide](../CONTRIBUTING.md).
- [X ] Make your Pull Request title in the
<https://www.conventionalcommits.org/> specification.
- Important Prefixes for
[release-please](https://github.com/googleapis/release-please):
- `fix:` which represents bug fixes, and correlates to a
[SemVer](https://semver.org/) patch.
- `feat:` represents a new feature, and correlates to a SemVer minor.
- `feat!:`, or `fix!:`, `refactor!:`, etc., which represent a breaking
change (indicated by the `!`) and will result in a SemVer major.
- [ X] Ensure the tests pass
- [X ] Appropriate READMEs were updated (if necessary)

Fixes #<issue_number_goes_here> 🦕

---------

Signed-off-by: Sebastien Dionne <[email protected]>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: survivant

CONTRIBUTING.md

@@ -19,7 +19,7 @@ This can be done by looking in the top-right corner of the repository page and c
 
 The next step is to clone your newly forked repository onto your local workspace. This can be done by going to your newly forked repository, which should be at `https://github.com/USERNAME/a2a-java`.
 
-Then, there will be a green button that says "Code". Click on that and copy the URL.
+Then, there will be a green button that says "Code". Click on it and copy the URL.
 
 Then, in your terminal, paste the following command:
 ```bash

README.md

@@ -40,9 +40,9 @@ The A2A Java SDK provides a Java server implementation of the [Agent2Agent (A2A)
 - [Add a class that creates an A2A Agent Card](#2-add-a-class-that-creates-an-a2a-agent-card)
 - [Add a class that creates an A2A Agent Executor](#3-add-a-class-that-creates-an-a2a-agent-executor)
 
-### 1. Add an A2A Java SDK Reference Server dependency to your project
+### 1. Add an A2A Java SDK Server Maven dependency to your project
 
-Adding a dependency on an A2A Java SDK Reference Server will provide access to the core classes
+Adding a dependency on an A2A Java SDK Server will provide access to the core classes
 that make up the A2A specification and allow you to run your agentic Java application as an A2A server agent.
 
 The A2A Java SDK provides [reference A2A server implementations](reference) based on [Quarkus](https://quarkus.io) for use with our tests and examples. However, the project is designed in such a way that it is trivial to integrate with various Java runtimes.
@@ -128,7 +128,7 @@ public class WeatherAgentCardProducer {
                 .skills(Collections.singletonList(new AgentSkill.Builder()
                         .id("weather_search")
                         .name("Search weather")
-                        .description("Helps with weather in city, or states")
+                        .description("Helps with weather in cities or states")
                         .tags(Collections.singletonList("weather"))
                         .examples(List.of("weather in LA, CA"))
                         .build()))
@@ -294,8 +294,7 @@ that you can use to create your A2A `Client`.
 
 ### 2. Add one or more dependencies on the A2A Java SDK Client Transport(s) you'd like to use
 
-By default, the sdk-client is coming with the JSONRPC transport dependency. Despite the fact that the JSONRPC transport 
-dependency is included by default, you still need to add the transport to the Client as described in [JSON-RPC Transport section](#json-rpc-transport-configuration).
+By default, the `sdk-client` artifact includes the JSONRPC transport dependency. However, you must still explicitly configure this transport when building the `Client` as described in the [JSON-RPC Transport section](#json-rpc-transport-configuration).
 
 
 If you want to use the gRPC transport, you'll need to add a relevant dependency:
@@ -505,8 +504,8 @@ client.sendMessage(message, customConsumers, customErrorHandler);
 // Retrieve the task with id "task-1234"
 Task task = client.getTask(new TaskQueryParams("task-1234"));
 
-// You can also specify the maximum number of items of history for the task
-// to include in the response and 
+// You can also specify the maximum number of history items for the task
+// to include in the response 
 Task task = client.getTask(new TaskQueryParams("task-1234", 10));
 
 // You can also optionally specify a ClientCallContext with call-specific config to use

client/base/src/main/java/io/a2a/A2A.java

@@ -136,7 +136,7 @@ private static Message toMessage(List<Part<?>> parts, Message.Role role, String
      * @param agentUrl the base URL for the agent whose agent card we want to retrieve
      * @return the agent card
      * @throws A2AClientError If an HTTP error occurs fetching the card
-     * @throws A2AClientJSONError f the response body cannot be decoded as JSON or validated against the AgentCard schema
+     * @throws A2AClientJSONError If the response body cannot be decoded as JSON or validated against the AgentCard schema
      */
     public static AgentCard getAgentCard(String agentUrl) throws A2AClientError, A2AClientJSONError {
         return getAgentCard(new JdkA2AHttpClient(), agentUrl);
@@ -149,7 +149,7 @@ public static AgentCard getAgentCard(String agentUrl) throws A2AClientError, A2A
      * @param agentUrl the base URL for the agent whose agent card we want to retrieve
      * @return the agent card
      * @throws A2AClientError If an HTTP error occurs fetching the card
-     * @throws A2AClientJSONError f the response body cannot be decoded as JSON or validated against the AgentCard schema
+     * @throws A2AClientJSONError If the response body cannot be decoded as JSON or validated against the AgentCard schema
      */
     public static AgentCard getAgentCard(A2AHttpClient httpClient, String agentUrl) throws A2AClientError, A2AClientJSONError  {
         return getAgentCard(httpClient, agentUrl, null, null);
@@ -164,7 +164,7 @@ public static AgentCard getAgentCard(A2AHttpClient httpClient, String agentUrl)
      * @param authHeaders the HTTP authentication headers to use
      * @return the agent card
      * @throws A2AClientError If an HTTP error occurs fetching the card
-     * @throws A2AClientJSONError f the response body cannot be decoded as JSON or validated against the AgentCard schema
+     * @throws A2AClientJSONError If the response body cannot be decoded as JSON or validated against the AgentCard schema
      */
     public static AgentCard getAgentCard(String agentUrl, String relativeCardPath, Map<String, String> authHeaders) throws A2AClientError, A2AClientJSONError {
         return getAgentCard(new JdkA2AHttpClient(), agentUrl, relativeCardPath, authHeaders);
@@ -180,7 +180,7 @@ public static AgentCard getAgentCard(String agentUrl, String relativeCardPath, M
      * @param authHeaders the HTTP authentication headers to use
      * @return the agent card
      * @throws A2AClientError If an HTTP error occurs fetching the card
-     * @throws A2AClientJSONError f the response body cannot be decoded as JSON or validated against the AgentCard schema
+     * @throws A2AClientJSONError If the response body cannot be decoded as JSON or validated against the AgentCard schema
      */
     public static AgentCard getAgentCard(A2AHttpClient httpClient, String agentUrl, String relativeCardPath, Map<String, String> authHeaders) throws A2AClientError, A2AClientJSONError  {
         A2ACardResolver resolver = new A2ACardResolver(httpClient, agentUrl, relativeCardPath, authHeaders);

client/base/src/main/java/io/a2a/client/ClientBuilder.java

@@ -91,14 +91,14 @@ private ClientTransport buildClientTransport() throws A2AClientException {
         // Get the preferred transport
         AgentInterface agentInterface = findBestClientTransport();
 
-        // Get the transport provider associated to the protocol
+        // Get the transport provider associated with the protocol
         ClientTransportProvider clientTransportProvider = transportProviderRegistry.get(agentInterface.transport());
         if (clientTransportProvider == null) {
             throw new A2AClientException("No client available for " + agentInterface.transport());
         }
         Class<? extends ClientTransport> transportProtocolClass = clientTransportProvider.getTransportProtocolClass();
 
-        // Retrieve the configuration associated to the preferred transport
+        // Retrieve the configuration associated with the preferred transport
         ClientTransportConfig<? extends ClientTransport> clientTransportConfig = clientTransports.get(transportProtocolClass);
 
         if (clientTransportConfig == null) {

common/src/main/java/io/a2a/common/A2AErrorMessages.java

@@ -3,7 +3,7 @@
 public final class A2AErrorMessages {
 
     private A2AErrorMessages() {
-        // prevent instantiation
+        // Prevent instantiation
     }
 
     public static final String AUTHENTICATION_FAILED = "Authentication failed: Client credentials are missing or invalid";

http-client/src/main/java/io/a2a/client/http/A2ACardResolver.java

@@ -35,7 +35,7 @@ public A2ACardResolver(String baseUrl) throws A2AClientError {
     }
 
     /**
-     /**Get the agent card for an A2A agent.
+     * Constructs an A2ACardResolver with a specific HTTP client and base URL.
      *
      * @param httpClient the http client to use
      * @param baseUrl the base URL for the agent whose agent card we want to retrieve
@@ -81,7 +81,7 @@ public A2ACardResolver(A2AHttpClient httpClient, String baseUrl, @Nullable Strin
      *
      * @return the agent card
      * @throws A2AClientError If an HTTP error occurs fetching the card
-     * @throws A2AClientJSONError f the response body cannot be decoded as JSON or validated against the AgentCard schema
+     * @throws A2AClientJSONError If the response body cannot be decoded as JSON or validated against the AgentCard schema
      */
     public AgentCard getAgentCard() throws A2AClientError, A2AClientJSONError {
         A2AHttpClient.GetBuilder builder = httpClient.createGet()

server-common/src/main/java/io/a2a/server/agentexecution/RequestContext.java

@@ -38,7 +38,7 @@ public RequestContext(
         this.relatedTasks = relatedTasks == null ? new ArrayList<>() : relatedTasks;
         this.callContext = callContext;
 
-        // if the taskId and contextId were specified, they must match the params
+        // If the taskId and contextId were specified, they must match the params
         if (params != null) {
             if (taskId != null && !taskId.equals(params.message().getTaskId())) {
                 throw new InvalidParamsError("bad task id");

transport/grpc/src/test/java/io/a2a/transport/grpc/handler/GrpcHandlerTest.java

@@ -742,7 +742,7 @@ public void testDeletePushNotificationConfigNoPushConfigStore() {
 
     @Disabled
     public void testOnGetAuthenticatedExtendedAgentCard() throws Exception {
-        // TODO - getting the authenticated extended agent card isn't support for gRPC right now
+        // TODO - getting the authenticated extended agent card isn't supported for gRPC right now
     }
 
     @Test