a2aproject / a2aproject/A2A

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

Ouverte
#1,651 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
Shell
Étoiles
25.8k
Forks
2.6k
Merge moyen
3 j 6 h
PR mergées (30 j)
16

Description

### 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

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

L’issue renvoie vers la page Key Concepts à l’adresse https://a2a-protocol.org/latest/topics/key-concepts/. Commencez par localiser les fichiers sources de cette documentation, probablement dans un répertoire docs/ ou website. Examinez le diagramme et le texte existants. Les tâches consistent à mettre à jour les diagrammes (un outil de diagramme peut être nécessaire), à clarifier la terminologie, par exemple en remplaçant 'Agent Response' par 'A2A Client' ou 'A2A Server', et à ajouter une section sur 'Agent Skills'. Vérifiez s’il existe des directives de contribution à la documentation. 'Done' signifie que la page a été mise à jour avec les corrections et les diagrammes proposés.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Domaine
documentation
Type d'issue
Documentation
Difficulté
3/5
Temps estimé
1-2 jours
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
55/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.