a2aproject / a2aproject/A2A

[Bug](docs): User Experience - A2A docs HomePage needs a revamp/re-ordering

Aberta
#1,650 0 comentários 0 reações 0 responsáveis Ver no GitHub
Linguagem predominante
Shell
Estrelas
25.7k
Forks
2.6k
Merge médio
3d 6h
PRs com merge (30d)
16

Descrição

### What happened?

A2A HomePage would need a revamp to address following problems
__
* **Problem 01:** Information about supported SDKs (Python, JavaScript, Java, C#, GoLang) is buried deep in the page and not immediately visible to developers.
* **Proposed Fix:** Move the SDK information to the top of the page. (As found in https://google.github.io/adk-docs/)
* **Justification:** This will provide a clear entry point for new users, making it easier for them to learn about A2A and its capabilities.

__
* **Problem02:** A visual aid is located in the “Why use A2A protocol” section but would be more effective in the “What is A2A protocol” section.
* **Proposed Fix:** Move the image to the “What is A2A protocol” section.
* **Justification:** This will create a more intuitive and streamlined user interface by placing the visual aid in a more logical context.

__
* **Problem03:** (When seen from a laptops/tablets) The homepage gives the first immediate impression that users can watch a YouTube video or DLAI take a course to get started, rather than being able to learn directly from the documentation. (Youtube Video & DLAI course appears before other key link to GetStart)
* **Proposed Fix:** Add a Table of Contents or re-arrange the content flow to introduce concepts first and then redirect them to the other sites.
* **Justification:** This will provide a clear and structured path for users to get started with A2A directly from the documentation.

### Relevant log output

```shell

```

### Code of Conduct

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

Guia de contribuição

Abrir o guia de contribuição

Avaliação

Esta issue ainda não foi avaliada.

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.