[Bug](docs): User Experience - A2A docs HomePage needs a revamp/re-ordering
- Lingua principale
- Shell
- Stelle
- 25.7k
- Fork
- 2.6k
- Merge medio
- 3g 6h
- PR unite (30g)
- 16
Descrizione
### 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
Guida per i contributori
Apri la guida per i contributori
Direzione di ricerca
The issue is about the A2A documentation homepage. Find the homepage source file (likely in a docs/ directory, possibly an index.md or README.md). Review the current layout to locate the SDK information, the visual aid image, and the placement of the YouTube/DLAI course links. Reorder sections as described: move SDK info to the top, relocate the image to the 'What is A2A protocol' section, and adjust content flow to prioritize documentation links. Verify changes by building or previewing the docs locally.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Stato di attività
- Ferma
- Chiarezza
- Specificata chiaramente
- Idoneità per principianti
- 70/100