From 6aa880cc67ea7a311ef641640bd0b99278e60cf7 Mon Sep 17 00:00:00 2001
From: Shubham Saboo <31396011+Shubhamsaboo@users.noreply.github.com>
Date: Wed, 29 Oct 2025 15:11:01 -0700
Subject: [PATCH 1/2] Revise README for clarity and consistency

Updated terminology in README for clarity and consistency.
---
 README.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 93d288b73f..365feda69b 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@
       <img src="https://raw.githubusercontent.com/google/adk-python/main/assets/agent-development-kit.png" width="256"/>
     </h2>
     <h3 align="center">
-      An open-source, code-first Python toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
+      An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
     </h3>
     <h3 align="center">
       Important Links:
@@ -22,7 +22,7 @@
     </h3>
 </html>
 
-Agent Development Kit (ADK) is a flexible and modular framework for developing and deploying AI agents. While optimized for Gemini and the Google ecosystem, ADK is model-agnostic, deployment-agnostic, and is built for compatibility with other frameworks. ADK was designed to make agent development feel more like software development, to make it easier for developers to create, deploy, and orchestrate agentic architectures that range from simple tasks to complex workflows.
+Agent Development Kit (ADK) is a flexible and modular framework that applies software development principles to AI agent creation. It's designed to simplify building, deploying, and orchestrating agent workflows, from simple tasks to complex systems. While optimized for Gemini, ADK is model-agnostic, deployment-agnostic, and compatible with other frameworks.
 
 ---
 
@@ -37,7 +37,7 @@ Agent Development Kit (ADK) is a flexible and modular framework for developing a
 ## ✨ Key Features
 
 - **Rich Tool Ecosystem**: Utilize pre-built tools, custom functions,
-  OpenAPI specs, or integrate existing tools to give agents diverse
+  OpenAPI specs, MCP tools or integrate existing tools to give agents diverse
   capabilities, all for tight integration with the Google ecosystem.
 
 - **Code-First Development**: Define agent logic, tools, and orchestration
@@ -54,13 +54,6 @@ Agent Development Kit (ADK) is a flexible and modular framework for developing a
 - **Deploy Anywhere**: Easily containerize and deploy agents on Cloud Run or
   scale seamlessly with Vertex AI Agent Engine.
 
-## 🤖 Agent2Agent (A2A) Protocol and ADK Integration
-
-For remote agent-to-agent communication, ADK integrates with the
-[A2A protocol](https://github.com/google-a2a/A2A/).
-See this [example](https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents)
-for how they can work together.
-
 ## 🚀 Installation
 
 ### Stable Release (Recommended)
@@ -84,6 +77,13 @@ pip install git+https://github.com/google/adk-python.git@main
 
 Note: The development version is built directly from the latest code commits. While it includes the newest fixes and features, it may also contain experimental changes or bugs not present in the stable release. Use it primarily for testing upcoming changes or accessing critical fixes before they are officially released.
 
+## 🤖 Agent2Agent (A2A) Protocol and ADK Integration
+
+For remote agent-to-agent communication, ADK integrates with the
+[A2A protocol](https://github.com/google-a2a/A2A/).
+See this [example](https://github.com/a2aproject/a2a-samples/tree/main/samples/python/agents)
+for how they can work together.
+
 ## 📚 Documentation
 
 Explore the full documentation for detailed guides on building, evaluating, and

From 57d574e2e28c539e97fcb7f5d82bc1d00ca7149e Mon Sep 17 00:00:00 2001
From: Hangfei Lin <hangfeilin@gmail.com>
Date: Thu, 30 Oct 2025 10:58:08 -0700
Subject: [PATCH 2/2] Improve readability of ADK description in README

Reformatted the description of the Agent Development Kit for better readability.
---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 365feda69b..61dfc40eac 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,11 @@
     </h3>
 </html>
 
-Agent Development Kit (ADK) is a flexible and modular framework that applies software development principles to AI agent creation. It's designed to simplify building, deploying, and orchestrating agent workflows, from simple tasks to complex systems. While optimized for Gemini, ADK is model-agnostic, deployment-agnostic, and compatible with other frameworks.
+Agent Development Kit (ADK) is a flexible and modular framework that applies
+software development principles to AI agent creation. It is designed to
+simplify building, deploying, and orchestrating agent workflows, from simple
+tasks to complex systems. While optimized for Gemini, ADK is model-agnostic,
+deployment-agnostic, and compatible with other frameworks.
 
 ---