a2aproject / a2aproject/A2A

BUG(docs): User Experience - With A2A Key Concepts Page

オープン
#1,651 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Shell
スター
25.8k
フォーク
2.6k
平均マージ
3日 6時間
マージ済み PR(30日)
16

説明

### What happened?

Multiple issues to be addressed in Key Concepts page.

**Page URL:** https://a2a-protocol.org/latest/topics/key-concepts/
--
* **Problem:** The core concepts diagram is helpful but feels incomplete(feels outdated) and does not answer all questions a user might have after taking a course on the subject.
* **Proposed Fix:** Use a schema diagram to show connections between different elements, add a lifecycle flowchart, and clarify who initiates requests.
* **Justification:** This will create a more comprehensive and informative diagram that better explains the core concepts of A2A.
--
* **Problem:** The term [Agent Response](https://a2a-protocol.org/latest/topics/key-concepts/#agent-response-task-or-message) is confusing in the context of A2A, which is a communication protocol between a server and a client.
* **Proposed Fix:** Use more specific terms like `A2A Client` or `A2A Server`.
* **Justification:** This will improve the clarity and precision of the documentation.
__
* **Problem:** No mention of "Agent Skills" in Key Concepts page.
* **Proposed Fix:** Introduce the concept of Agent Skills earlier in the documentation.
* **Justification:** This will provide a more logical learning path for new users.

### Relevant log output

```shell

```

### Code of Conduct

- [x] I agree to follow this project's Code of Conduct

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

この issue は https://a2a-protocol.org/latest/topics/key-concepts/ の Key Concepts ページを指しています。まず、このドキュメントのソースファイルを探してください。おそらく docs/ または website ディレクトリにあります。既存の図とテキストを確認してください。作業には、図の更新(図作成ツールが必要になる場合があります)、'Agent Response' を 'A2A Client' または 'A2A Server' にするなどの用語の明確化、'Agent Skills' セクションの追加が含まれます。ドキュメントへのコントリビューションに関するガイドラインがないか確認してください。'Done' は、提案された修正と図を反映してページが更新されていることを意味します。

索引モデルが issue の本文から書いたものです。

評価

領域
documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
55/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。