## Problem **The "filename” metadata label** in key-concept.md does not quite align with FileBase property. As indicated in the specification.md, name, mineType or bytes labels are part of the FilePart metadatas, instead of using filename label. <img width="950" height="557" alt="image" src="https://github.com/user-attachments/assets/de687e31-e184-4036-a35b-763649bae682" /> ## Solution Replace “filename” metadata label with “name” label to align with FileBase property. ## Changes Modify A2A\docs\topics\key-concepts.md and **replace “filename” metadata label with “name” label** to better align with FileBase property from specification. ## Testing ✅ Documentation builds successfully with mkdocs ✅ Markdown linting passes ✅ All internal anchor links verified ✅ No broken cross-references ## Issue Fixes #1167
A2A Docs
Developing A2A docs
- Clone this repository and
cdinto the repository directory - Run
pip install -r requirements-docs.txt - Run
mkdocs serve, edit.mdfiles, and live preview - Contribute docs changes as usual
How it works
- The A2A docs use mkdocs and the mkdocs-material theme
- All of the source documentation / Markdown files related to the A2A docs are
in the
docs/directory in the A2A repository mkdocs.ymlin the repository root contains all of the docs config, including the site navigation and organization- There is a GitHub Action in
.github/workflows/docs.ymlthat builds and publishes the docs and pushes the built assets to thegh-pagesbranch in this repository usingmkdocs gh-deploy --force. This happens automatically for all commits / merges tomain. - The A2A documentation is hosted in GitHub pages, and the settings for this are in the A2A repository settings in GitHub.
Building the Python SDK Documentation
The Python SDK documentation is built using Sphinx.
Prerequisites
Ensure you have installed the documentation dependencies:
pip install -r ../../requirements-docs.txt
Building the Docs
-
Run the following command to build the HTML documentation:
sphinx-build -b html docs/sdk/python docs/sdk/python/api -
The generated HTML files will be in the
sdk/python/apidirectory. You can opensdk/python/api/index.htmlin your browser to view the documentation.